GHSV Developer
  • Giới thiệu
  • API
    • ⚙️Xác thực / môi trường
    • 🗺️Địa chỉ
    • 🛍️Cửa hàng
    • 📦Đơn hàng
  • Webhook
    • Đơn hàng cập nhật
  • Thông tin khác
    • Danh sách trạng thái
  • Lịch sử phiên bản
    • 1.0.3
    • 1.0.2
    • 1.0.1
Powered by GitBook
On this page
  • Tạo đơn hàng.
  • Tính phí đơn hàng.
  • Hủy đơn hàng.
  • Lấy thông tin đơn hàng.
  • Lấy hành trình đơn hàng.
  1. API

Đơn hàng

API liên quan đến đơn hàng trong hệ thống của GHSV.

Tạo đơn hàng.

POST https://api.ghsv.vn/v1/order/create

Headers

Name
Type
Description

Token*

String

token-cua-ban

Content-Type*

String

application/json

Request Body

Name
Type
Description

product*

String

Tên đơn hàng

to_name*

String

Tên người nhận

to_ward*

String

Xã người nhận

to_district*

String

Huyện người nhận

to_province*

String

Tỉnh người nhận

to_address*

String

Địa chỉ chi tiết người nhận

weight*

Int

Cân nặng kiện hàng (gram)

price*

Int

Tiền hàng

value

Int

Giá trị đơn hàng, dùng để tính tiền bảo hiểm

client_code

String

Mã đơn tùy chỉnh của bạn

note

String

Ghi chú giao hàng

config_delivery

Int

Cấu hình giao hàng gồm:

(1) Cho Xem Hàng Nhưng Không Cho Thử Hàng (mặc định) (2) Cho Thử Hàng

(3) Không Cho Xem Hàng

config_collect

Int

Cấu hình thu hộ gồm:

(0) Thu hộ = Tiền hàng (price) + phí (mặc định )

(1) Thu hộ = Tiền hàng (price)

is_return

Boolean

Hàng đổi trả ( mặc định: false )

to_phone*

String

Số điện thoại người nhận

shop_id*

Int

ID cửa hàng

source

String

Nguồn lên đơn (TPOS, TRUSTSALES, HARAVAN, PANCAKE), liên hệ kỹ thuật để thêm nguồn.

length

Int

Chiều dài kiện hàng (cm)

width

Int

Chiều rộng kiện hàng (cm)

height

Int

Chiều cao kiện hàng (cm)

{
    "success": false,
    "msg": "Tên người nhận không được bỏ trống."
}
{
    "success": true,
    "msg": "",
    "order": {
        "client_code": "TESTING7",
        "required_code": "YCCL.1400000010", // mã đơn hàng của GHSV
        "sorting_code" "BN280-00-00-02", // mã phân loại || null nếu chưa có
        "product": "Test",
        "weight": 100,
        "value": 0,
        "cod": 17000,
        "note": "Cho Xem Hàng Nhưng Không Cho Thử Hàng",
        "config_collect": 0,
        "is_return": false,
        "shop_id": 35,
        "fee": 16500,
        "to_name": "Thịnh",
        "to_phone": "0378872140",
        "to_address": "Test",
        "to_province": "Tỉnh Hải Dương",
        "to_district": "Thành phố Hải Dương",
        "to_ward": "Phường Tứ Minh"
    }
}

Tính phí đơn hàng.

GET https://api.ghsv.vn/v1/order/calcFee

Headers

Name
Type
Description

Token*

String

token-cua-ban

Content-Type*

String

application/json

Request Body

Name
Type
Description

weight*

Int

Cân nặng đơn hàng (g)

value

Int

Giá trị đơn hàng, dùng để tính tiền bảo hiểm

to_ward*

String

Xã người nhận

to_district*

String

Huyện người nhận

to_province*

String

Tỉnh người nhận

shop_id*

Int

ID cửa hàng

config_collect

Int

Cấu hình thu hộ gồm:

(0) Thu hộ = Tiền hàng (price) + phí (mặc định )

(1) Thu hộ = Tiền hàng (price)

{
    "success": true,
    "msg": false,
    "fee": 24000
}
{
    "success": false,
    "msg": "Trường shop_id không được bỏ trống."
}

Hủy đơn hàng.

POST https://api.ghsv.vn/v1/order/cancel

Headers

Name
Type
Description

Token*

String

token-cua-ban

Content-Type*

String

application/json

Request Body

Name
Type
Description

required_code

String

Mã đơn hàng của GHSV

Bỏ trường client_code

client_code

String

Mã đơn tùy chỉnh của bạn

Bỏ trường required_code

{
    "success": true,
    "msg": ""
}
{
    "success": false,
    "msg": "Đơn hàng này không thể hủy."
}

Lấy thông tin đơn hàng.

GET https://api.ghsv.vn/v1/order/info

Headers

Name
Type
Description

Token*

String

token-cua-ban

Content-Type*

String

application/json

Request Body

Name
Type
Description

required_code

String

Mã đơn hàng của GHSV

Bỏ trường client_code

client_code

String

Mã đơn tùy chỉnh của bạn

Bỏ trường required_code

{
    "success": true,
    "msg": "",
    "order": {
        "status": "Hoãn Giao Hàng",
        "audit_code": null, // mã đối soát GHSV
        "delivery_time": null,
        "client_code": "",
        "required_code": "YCCL.1400000004", // mã yêu cầu của GHSV
        "product": "test",
        "weight": 300,
        "value": 0,
        "cod": 65000,
        "note": "Cho Xem Hàng Nhưng Không Cho Thử Hàng",
        "config_collect": 0,
        "is_return": false,
        "shop_id": 0,
        "to_name": "test",
        "to_phone": "0378872140",
        "to_address": "test, test",
        "to_province": "Thành Phố Cần Thơ",
        "to_district": "Quận Ô Môn",
        "to_ward": "Phường Long Hưng",
        "fee": 35000
    }
}
{
    "success": false,
    "msg": "Đơn hàng không tồn tại."
}

Lấy hành trình đơn hàng.

GET https://api.ghsv.vn/v1/order/tracking

Headers

Name
Type
Description

Token*

String

token-cua-ban

Content-Type*

String

application/json

Request Body

Name
Type
Description

required_code

String

Mã đơn hàng của GHSV

Bỏ trường client_code

client_code

String

Mã đơn tùy chỉnh của bạn

Bỏ trường required_code

{
    "success": true,
    "msg": "",
    "tracking": [
        {
            "time": "09-05-2022 12:01",
            "status": "Đã được đối soát",
            "address": "",
            "note": "Mã đối soát: 09052022_1"
        },    
        {
            "time": "06-05-2022 15:50",
            "status": "Đã Giao Hàng Toàn Bộ",
            "address": "",
            "note": "Nguyễn Đức Thịnh (0378872140) xác nhận Đã Giao Hàng Toàn Bộ lúc 15:50 06-05-2022"
        },
        {
            "time": "06-05-2022 15:42",
            "status": "Đang xử lý",
            "address": "",
            "note": ""
        },
        {
            "time": "06-05-2022 15:41",
            "status": "Đã nhập kho",
            "address": "",
            "note": ""
        },
        {
            "time": "05-05-2022 19:56",
            "status": "Đợi lấy hàng",
            "address": "",
            "note": ""
        }
    ],
    "response_code": 200,
    "status": "success"
}
{
    "success": false,
    "msg": "Đơn hàng không tồn tại."
}
PreviousCửa hàngNextĐơn hàng cập nhật

Last updated 2 years ago

📦
Khởi tạo Token
Khởi tạo Token
Khởi tạo Token
Khởi tạo Token
Khởi tạo Token
#lay-danh-sach-cac-xa-phuong-trong-csdl-cua-ghsv.
#lay-danh-sach-cac-quan-huyen-trong-csdl-cua-ghsv.
#lay-danh-sach-cac-tinh-thanh-trong-csdl-cua-ghsv.
#lay-danh-sach-cac-xa-phuong-trong-csdl-cua-ghsv.
#lay-danh-sach-cac-quan-huyen-trong-csdl-cua-ghsv.
#lay-danh-sach-cac-tinh-thanh-trong-csdl-cua-ghsv.
#khoi-tao-cua-hang.
#khoi-tao-cua-hang.