TỔNG QUAN:
Tích hợp đầy đủ API Giao Hàng Nhanh (GHN) cho OpenCart 4.x. Tính phí ship
real-time, tự động đăng đơn, webhook đồng bộ trạng thái, và dashboard quản lý
đơn hàng toàn diện trong admin.

TÍNH NĂNG CHÍNH:
- Hỗ trợ 2 môi trường: Staging + Production (token/Shop ID riêng biệt)
- Tính phí vận chuyển real-time qua API GHN
- Hỗ trợ nhiều dịch vụ: Giao nhanh (Express) + Tiêu chuẩn (Standard)
- Cache phí ship cấu hình được (0-3600 giây, mặc định 5 phút; đặt 0 = real-time)
- Hỗ trợ thuế và khu vực giao hàng (Tax Class & Geo Zone)
- Song ngữ: Tiếng Anh + Tiếng Việt

TỰ ĐỘNG QUẢN LÝ ĐƠN HÀNG:
- Tự động đăng đơn lên GHN khi khách checkout (qua hệ thống event OpenCart)
- Xử lý COD thông minh: đơn COD chỉ đăng khi admin chuyển sang trạng thái Đang xử lý
- Đơn thanh toán online tự động đăng ngay lập tức
- Tự động huỷ đơn trên GHN khi admin huỷ đơn trong OpenCart
- Chống đăng đơn trùng lặp
- Webhook: tự động đồng bộ 22+ trạng thái GHN sang trạng thái đơn OpenCart
- Ánh xạ trạng thái cấu hình được (Đã giao/Hoàn thành/Xác nhận hoàn trả)

DASHBOARD QUẢN LÝ ĐƠN HÀNG (ADMIN):
- Thẻ thống kê: Tổng, Đã giao, Đang giao, Đang vận chuyển, Đang lấy,
Đã hoàn, Đã huỷ, Giao thất bại, Có vấn đề
- Lọc nâng cao: Mã đơn OC, mã vận đơn GHN, trạng thái, khoảng ngày
- Bảng đơn hàng sắp xếp được, phân trang
- Thao tác: Đồng bộ trạng thái, Theo dõi, In nhãn, Huỷ đơn, Yêu cầu hoàn trả
- In nhãn hàng loạt (khổ A5, nhiều đơn trong 1 file PDF)
- Theo dõi trạng thái in (cờ in chưa + ngày in)
- Danh sách đơn COD chờ xử lý: hiển thị đơn COD chưa đăng lên GHN

QUẢN LÝ HOÀN TRẢ:
- Admin xác nhận hoàn trả thủ công
- Tự động khôi phục tồn kho (sản phẩm + tuỳ chọn/biến thể)
- Ghi nhận ai xác nhận và thời gian
- Tự động cập nhật trạng thái đơn OpenCart

XỬ LÝ ĐỊA CHỈ:
- Dropdown AJAX liên tầng: Tỉnh > Quận/Huyện > Phường/Xã (từ API GHN)
- Ánh xạ custom field cho Quận/Huyện và Phường/Xã
- Khớp địa chỉ tiếng Việt mờ (bỏ dấu, không phân biệt hoa thường)
- Xử lý các biến thể tên địa chỉ và bí danh

TÍNH PHÍ VẬN CHUYỂN:
- Chuyển đổi trọng lượng: kg, g, lb, oz sang gram (tự động nhận diện từ cấu hình OC)
- Hỗ trợ kích thước sản phẩm (dài x rộng x cao)
- Trọng lượng mặc định cấu hình được
- Tính tiền COD chính xác từ bảng order_total

KỸ THUẬT:
- 16 file, tích hợp 31 endpoint API GHN
- Bảng CSDL: oc_ghn_order (26 trường dữ liệu mỗi đơn)
- Event hook: catalog/model/checkout/order.addHistory/after
- Tự động cấp quyền khi cài đặt
- Gỡ cài đặt sạch (xoá bảng, xoá event)
- Bảo mật: SSL, kiểm tra quyền, chống SQL injection