📦Đơ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.svexpress.vn/v1/open-api/order/create

Headers

Name	Type	Description
Content-type*	String	application/json
Token	String	token-cua-ban Khởi tạo Token

Request Body

Name	Type	Description
shop_id*	int	ID cửa hàng Cửa 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
value	int	Giá trị đơn hàng, dùng để tính tiền bảo hiểm
price*	int	Tiền hàng
height	int	Chiều cao kiện hàng (cm)
width	int	Chiều rộng kiện hàng (cm)
length	int	Chiều dài kiện hàng (cm)
weight*	int	Cân nặng kiện hàng (gram)
product*	String	Tên đơn hàng
to_name*	String	Tên người nhận
note	String	Ghi chú giao hàng
client_code	String	Mã đơn tùy chỉnh của bạn
is_return	Boolean	Hàng đổi trả ( mặc định: false )
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)
to_dicstrict*	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
to_phone*	String	Số điện thoại người nhận
to_ward*	String	Xã người nhận Địa chỉ
source	String	Nguồn lên đơn (TPOS, TRUSTSALES, HARAVAN, PANCAKE), liên hệ kỹ thuật để thêm nguồn.

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

{
    "success": true,
    "msg": "",
    "order": {
        "client_code": "TESTING7",
        "required_code": "YCCL.1400000010", // mã đơn hàng của GHSV
        "order_code": "YCCL.1400000010",
        "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"
    }
}

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

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

POSThttps://api.svexpress.vn/v1/open-api/order/calcFee

Headers

Name	Type	Description
Content-Type*	String	application/json
Token*	String	token-cua-ban Khởi tạo Token

Request Body

Name	Type	Description
shop_id*	Int	ID cửa hàng Cửa hàng
to_district*	String	Huyện người nhận Địa chỉ
to_ward*	String	Xã người nhận Địa chỉ
config_collect	String	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)
vale	String	Giá trị đơn hàng, dùng để tính tiền bảo hiểm
weight*	String	Cân nặng đơn hàng (g)
to_province*	String	Tỉnh người nhận Địa chỉ
price*	Number	Tiền hàng

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

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

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

Hủy đơn hàng.

POST https://api.svexpress.vn/v1/open-api/order/cancel

Headers

Name	Type	Description
Content-Type*	String	application/json
Token*	String	token-cua-ban Khởi tạo Token

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

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

GET https://api.svexpress.vn/v1/open-api/order/info

Headers

Name	Type	Description
Content-Type*	String	application/json
Token*	String	token-cua-ban Khởi tạo Token

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

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

GET https://api.svexpress.vn/v1/order/open-api/tracking

Headers

Name	Type	Description
Content-Type*	String	application/json
client_code*	String	token-cua-ban Khởi tạo Token

Request Body

Name	Type	Description
required_code	String	Mã đơn hàng của GHSV Bỏ trường client_code
client_code*		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