Order
Danh sách đơn hàng
GET
/apis/v1/merchant/order/list
Query Parameters
per_page
Text
Số trang
page
Text
Trang
update_time
TIMESTAMP
Thời gian cập nhật
Headers
pm-mc-code
String
Xem hướng dẫn tại About
pm-mc-token
String
Xem hướng dẫn tại About
{
"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:
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
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
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
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
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
{
"code": "success",
"message": "Thành công",
"result": null,
"requestMethod": ""
}
Tạo đơn hàng
POST
/apis/v1/merchant/order/create
Headers
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
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"
}
{
"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
Last updated