Developer
Đăng nhập

GHNDeveloper

Kết nối hệ thống của bạn
với mạng lưới giao vận GHN

Tài liệu đầy đủ, endpoint chuẩn REST và môi trường thử nghiệm riêng — mọi thứ bạn cần để đưa vận chuyển GHN vào hệ thống của mình.

Tạo đơn hàng đầu tiên với GHN API

200 · Tạo đơn thành công

{
  "code": 200,
  "message": "Success",
  "data": {
    "order_code": "5F9NL3RH",
    "total_fee": 22000,
    "expected_delivery_time": "2026-07-17T23:59:59+07:00"
  }
}
Tạo đơn hàngTính phíThời gian giao dự kiếnTheo dõi đơnIn vận đơnĐối soát CODWebhook realtimeĐịa chỉ 3 cấpBưu cục & khoTicket hỗ trợTrả hàngCa lấy hàng

Tổng quan

Danh mục API

API công khai theo chuẩn REST/JSON, nhóm theo từng nghiệp vụ giao vận.

Bắt đầuTổng quan API và cách lấy token để gọi request đầu tiên tới GHN.
TokenTạo tài khoản và lấy token xác thực cho hệ thống của bạn.
Đơn hàngToàn bộ vòng đời đơn hàng: tạo, cập nhật, hủy, in vận đơn, phí và theo dõi.
Dữ liệu chungDanh mục tỉnh/thành, quận/huyện, phường/xã, bưu cục, dịch vụ và ca lấy hàng.
Cửa hàngQuản lý danh sách cửa hàng / kho lấy hàng gắn với tài khoản.
WebhookNhận trạng thái đơn hàng và ticket realtime qua callback URL.
TicketTạo và theo dõi yêu cầu hỗ trợ vận đơn ngay từ hệ thống của bạn.
AffiliateTạo cửa hàng và nhân viên thay khách hàng qua luồng OTP.

Nhóm API Đơn hàng

Quản lý trọn vòng đời đơn hàng

Tạo đơn, cập nhật, hủy, giao lại, in vận đơn và tra cứu trạng thái. Mỗi thao tác là một endpoint riêng với tham số và response được mô tả đầy đủ.

Nhóm API Phí & dịch vụ

Tính phí và thời gian giao dự kiến

Tính cước theo tuyến, khối lượng và gói dịch vụ; kèm API thời gian giao dự kiến để hiển thị thông tin vận chuyển trước khi tạo đơn.

Webhook

Nhận trạng thái đơn qua webhook

Đăng ký callback URL một lần, GHN gửi các thay đổi trạng thái đơn hàng và dòng tiền COD về hệ thống của bạn theo thời gian thực, không cần polling.

Bắt đầu nhanh

Tích hợp trong 4 bước

Làm theo 4 bước dưới đây để đẩy đơn hàng thật lên GHN.

  1. 01

    Tạo tài khoản

    Đăng ký miễn phí trên khachhang.ghn.vn (hoặc môi trường staging 5sao.ghn.dev).

  2. 02

    Lấy token & ShopId

    Vào phần cài đặt tài khoản để lấy API token và mã cửa hàng.

  3. 03

    Gọi thử trên môi trường staging

    Thử tạo đơn, tính phí với dữ liệu giả lập — không phát sinh đơn thật.

  4. 04

    Go-live

    Đổi endpoint sang production và bắt đầu đẩy đơn hàng thật tới GHN.