📦Đơ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 Khởi tạo Token
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 Địa chỉ
to_district*	String	Huyện người nhận Địa chỉ
to_province*	String	Tỉnh người nhận Địa chỉ
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 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)

200: OK Tạo đơn hàng thất bại

{
    "success": false,
    "msg": "Tên người nhận không được bỏ trống."
}

200: OK Tạo đơn hàng thành cô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 Khởi tạo Token
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 Địa chỉ
to_district*	String	Huyện người nhận Địa chỉ
to_province*	String	Tỉnh người nhận Địa chỉ
shop_id*	Int	ID cửa hàng 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)

200: OK Tính phí thành công

{
    "success": true,
    "msg": false,
    "fee": 24000
}

200: OK Tính phí thất bại

{
    "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 Khởi tạo Token
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

200: OK Hủy đơn hàng thành công

{
    "success": true,
    "msg": ""
}

200: OK Hủy đơn hàng thất bại

{
    "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 Khởi tạo Token
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

200: OK Lấy thông tin đơn hàng thành công

{
    "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
    }
}

200: OK Lấy thông tin đơn hàng thất bại

{
    "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 Khởi tạo Token
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

200: OK Lấy hành trình đơn hàng thành công

{
    "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"
}

200: OK Lấy hành trình đơn hàng thất bại

{
    "success": false,
    "msg": "Đơn hàng không tồn tại."
}