Order

• Danh sách đơn hàng

GET /apis/v1/merchant/order/list

Query Parameters

Name	Type	Description
per_page	Text	Số trang
page	Text	Trang
update_time	TIMESTAMP	Thời gian cập nhật

Headers

Name	Type	Description
pm-mc-code	String	Xem hướng dẫn tại About
pm-mc-token	String	Xem hướng dẫn tại About

200: OK

{
    "code": "success",
    "message": "Thành công",
    "result": {
        "data": [
            {
                "order_id": 73,
                "shipping_code": "ER618950912VN",
                "order_sn": "6000000000007101",
                "pay_sn": "23071409293982075004",
                "store_id": 3,
                "store_name": "Mune",
                "buyer_id": 4,
                "buyer_name": "customer",
                "buyer_email": null,
                "chain_id": 0,
                "add_time": 1689301779,
                "payment_code": "offline",
                "payment_time": 0,
                "trade_no": null,
                "finnshed_time": 0,
                "goods_amount": "350000.00",
                "order_amount": "382226.00",
                "shipping_fee": "32226.00",
                "evaluation_state": 0,
                "order_state": 35,
                "refund_state": 0,
                "lock_state": 0,
                "delete_state": 0,
                "refund_amount": "0.00",
                "order_from": 1,
                "state_desc": "order_state_pickup",
                "update_time": 1749630311,
                "payment_name": "Thanh toán CoD",
                "extend_order_common": {
                    "order_id": 73,
                    "store_id": 3,
                    "shipping_time": 1689329903,
                    "shipping_express_id": 48,
                    "order_message": "đơn hàng test, không duyệt đơn này",
                    "voucher_price": null,
                    "voucher_code": null,
                    "mallvoucher_price": null,
                    "mallvoucher_code": null,
                    "reciver_name": "Nghia Nguyen",
                    "reciver_info": {
                        "address": "Mỹ Đình 2,Nam Từ Liêm,Hà Nội 5 pham hung",
                        "phone": "0987654321",
                        "area": "Mỹ Đình 2,Nam Từ Liêm,Hà Nội",
                        "street": "5 pham hung",
                        "mob_phone": "0987654321",
                        "tel_phone": "",
                    },
                "update_time": 1749630311
                },
                "extend_order_goods": [
                    {
                        "order_id": 73,
                        "goods_id": 4600,
                        "goods_name": "Dầu dưỡng tóc Lucido-L",
                        "goods_price": "350000.00",
                        "goods_num": 1,
                        "goods_image": "alioss_3_2023071409003995369.jpg",
                        "goods_pay_price": "350000.00",
                        "store_id": 3,
                        "buyer_id": 4,
                        "gc_id": 1068,
                        "goods_weight": 300,
                        "package_weight": 100
                    }
                ]
            }
        ],
        "page": 1,
        "lastPage": 26,
        "total": 26
    },
    "requestMethod": ""
}

+ Mô tả respones 200:

Key	Bắt buộc	Mô tả
order_id	x	ID đơn hàng
shipping_code		Mã vận đơn (sau khi duyệt đơn)
order_sn	x	Đơn hàng
pay_sn	x	Mã giao dịch
store_id	x	ID cửa hàng
store_name	x	Tên cửa hàng
buyer_id	x	ID khách hàng
buyer_name	x	Tên khách hàng
buyer_email		Mail của khách hàng
chain_id	x	ID thông tin của khách hàng
add_time	x	Thời gian đặt đơn hàng
payment_code	x	Phương thức thanh toán
payment_time		Thời gian thanh toán
trade_no		Số giao dịch
finnshed_time	x	Ngày đã thanh toán
goods_amount	x	Giá sản phẩm
order_amount	x	Giá đơn hàng
shipping_fee	x	Phí vận chuyển
evaluation_state		Trạng thái đánh giá đơn hàng ( 0: Chưa đánh giá; 1: Đã đánh giá; 2: Đã hết thời gian đánh giá)
order_state	x	Trạng thái đơn hàng ( 0: Đơn hàng bị hủy; 10: Đơn hàng chưa thanh toán(với đơn thanh toán trực tuyến); 20: Đang giao hàng; 35: Bưu tá đang gom hàng; 40: Đã nhận hàng)
refund_state		Tình trạng hoàn tiền đơn hàng ( 0: Không hoàn; 1: Hoàn trả một phần; 2: Hoàn trả toàn bộ)
lock_state		Tình trạng khóa đơn hàng ( 0: Không khóa; số lớn hơn 0: Bị khóa)
delete_state	x	Tình trạng xóa đơn hàng. Giá trị ( 0: Không xóa; 1: Đã đưa vào thùng rác; 2: Xóa hoàn toàn)
refund_amount		Số tiền hoàn đơn hàng
delay_time		Thời gian giao trễ
order_from	x	Phương thức đặt hàng ( từ web hoặc app)
extend_order_common		Thông tin chi tiết đơn đặt hàng
voucher_price		Số tiền giảm giá từ voucher của cửa hàng
voucher_code		Mã voucher của cửa hàng
mallvoucher_price		Số tiền giảm giá từ voucher của Sàn
mallvoucher_code		Mã voucher của Sàn
reciver_name		Tên người nhận hàng
reciver_info		Thông tin chi tiết nhận hàng
extend_order_goods		Thông tin chi tiết sản phẩm trong đơn hàng
goods_id		Mã sản phẩm
goods_name		Tên sản phẩm
goods_price		Giá sản phẩm
goods_num		Số lượng sản phẩm đặt hàng
goods_image		Hình ảnh sản phẩm
goods_weight		Trọng lượng sản phẩm
package_weight		Khối lượng bao bì đóng gói sản phẩm
order_message		Ghi chú đơn hàng

• Cập nhật trạng thái đơn hàng

+ Xác nhận đơn hàng

Xác nhận đơn hàng

POST /apis/v1/merchant/order/change-status

Headers

Name	Type	Description
pm-mc-code*	String	Xem hướng dẫn tại About
pm-mc-token*	String	Xem hướng dẫn tại About

Request Body

Name	Type	Description
status*	String	accepted
order_sn*	String	Điền mã đơn hàng cần xác nhận
shipping_type*	String	eorder
shipping_express_code*	String	VNPOST

+ Hủy đơn hàng

Hủy đơn hàng

POST /apis/v1/merchant/order/change-status

Headers

Name	Type	Description
pm-mc-code*	String	Xem hướng dẫn tại About
pm-mc-token*	String	Xem hướng dẫn tại About

Request Body

Name	Type	Description
status*	String	canceled
order_sn*	String	Điền mã đơn hàng cần hủy
shipping_type*	String	eorder
shipping_express_code*	String	VNPOST

200: OK success

{
    "code": "success",
    "message": "Thành công",
    "result": null,
    "requestMethod": ""
}

Tạo đơn hàng

POST /apis/v1/merchant/order/create

Headers

Name	Type	Description
pm-mc-code*	String	Xem hướng dẫn tại About
pm-mc-token*	String	Xem hướng dẫn tại About
Content-Type		application/json

Request Body

Name	Description
order_code*	Mã đơn hàng
user_id*	ID người dùng
products*	Sản phẩm
goods_id*	ID sản phẩm
qty*	Số lượng
address*	Địa chỉ
province_code*	Mã tỉnh/thành phố
district_code*	Mã quận/huyện
ward_code*	Mã phường/xã
street*	Đường
payment_type*	offline (Phương thức thanh toán)
express_type*	standard (Phương thức vận chuyển)
order_message	Ghi chú đơn hàng

// Example
{
    "order_code": "VNP12345",
    "user_id": 1,
    "products": [
        {
            "goods_id": 26,
            "qty": 1
        },
        {
            "goods_id": 27,
            "qty": 1
        },
        {
            "goods_id": 28,
            "qty": 4
        }
    ],
    "address": {
        "province_code": 1,
        "district_code": 525,
        "ward_code": 2415,
        "street": "5 Phạm Hùng"
    },
    "payment_type": "offline",
    "express_type": "standard",
    "order_message": "Ghi chú đơn hàng"
}

200: OK success

{
    "code": "success",
    "message": "Tạo đơn hàng thành công",
    "result": {
        "order_code": "VNP12345",
        "user_id": "1",
        "products": [
            {
                "goods_id": "2",
                "qty": "4"
            }
        ],
        "address": {
            "province_code": "1",
            "district_code": "525",
            "ward_code": "2415",
            "street": "5 Phạm Hùng"
        },
        "payment_type": "offline",
        "express_type": "standard",
        "order_message": "Ghi chú đơn hàng"
    },
    "requestMethod": ""
}

Token để tạo đơn hàng phải dùng token của Merchant