Hủy đơn

Hủy đơn hàng đã tạo thông qua Mã đơn Ahamove hoặc Mã đơn hàng nội bộ (tracking_number)

Chỉ có thể hủy đơn hàng khi đơn đang có những trạng thái bên dưới:

• IDLE, ASSIGNING, ACCEPTED, CONFIRMING, PAYING
• comment đã được Ahamove chuẩn hóa tại Các lý do hủy đơn. Đối tác chỉ cần sử dụng các lý do dành cho User, comment tương ứng với cột En hoặc Vi để truyền vào API khi Đối tác có nhu cầu hủy đơn hàng

Hủy đơn bằng mã đơn Ahamove

cURL

curl --location --request DELETE 'https://partner-apistg.ahamove.com/v3/orders/<order_id>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "comment": "Khách hàng muốn hủy đơn"
}'

JavaScript

const myHeaders = new Headers();
myHeaders.append('Content-Type', 'application/json');
myHeaders.append('Authorization', 'Bearer <token>');

const raw = JSON.stringify({
  comment: 'Khách hàng muốn hủy đơn',
});

const requestOptions = {
  method: 'DELETE',
  headers: myHeaders,
  redirect: 'follow',
};

fetch('https://partner-apistg.ahamove.com/v3/orders/<order_id>', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

HTTP Request

DELETE https://partner-apistg.ahamove.com/v3/orders/<order_id>

Headers

Parameter	Value	Yêu cầu	Mô tả
Content-Type	application/json	Có
Authorization	Bearer <token>	Có	Token của tài khoản tạo đơn

Query Parameters

Parameter	Type	Yêu cầu	Mô tả
order_id	String	Có	Mã đơn hàng cần hủy
comment	String	Có	Lý do hủy đơn (Bắt buộc nếu hủy đơn ở trạng thái ACCEPTED)

Hủy đơn bằng mã đơn hàng nội bộ (tracking_number)

Đối với đơn 1-N (1 điểm lấy hàng - N điểm giao hàng), khi Đối tác hủy đơn bằng mã tracking number của điểm giao hàng thì mã đơn hàng chứa các điểm giao cũng sẽ bị hủy.

cURL

curl --location --request DELETE 'https://partner-apistg.ahamove.com/v3/orders/tracks' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "tracking_number": "HD00001",
    "comment": "Khách hàng muốn hủy đơn"
}'

JavaScript

const myHeaders = new Headers();
myHeaders.append('Content-Type', 'application/json');
myHeaders.append('Authorization', 'Bearer <token>');

const raw = JSON.stringify({
  tracking_number: 'HD00001',
  comment: 'Khách hàng muốn hủy đơn',
});

const requestOptions = {
  method: 'DELETE',
  headers: myHeaders,
  redirect: 'follow',
};

fetch('https://partner-apistg.ahamove.com/v3/orders/tracks', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

HTTP Request

DELETE https://partner-apistg.ahamove.com/v3/orders/tracks

Headers

Parameter	Value	Yêu cầu	Mô tả
Content-Type	application/json	Có
Authorization	Bearer <token>	Có	Token của tài khoản tạo đơn

Query Parameters

Parameter	Type	Yêu cầu	Mô tả
tracking_number	String	Có	Mã đơn hàng nội bộ của đơn cần hủy
comment	String	Có	Lý do hủy đơn (Bắt buộc nếu hủy đơn ở trạng thái ACCEPTED)

Response

JSON response example:

{}

Status-Code: 200 OK

Các lỗi thường gặp

Mã lỗi	Nội dung	Mô tả
401	NOT_AUTHORIZED	Không có quyền hủy đơn
404	ORDER_NOT_FOUND	Không tìm thấy mã đơn hàng
406	INVALID_ORDER_STATUS	Trạng thái đơn hàng không hợp lệ
500	INTERNAL_SERVER_ERROR	Hệ thống của chúng tôi có lỗi xảy ra. Xin thử lại sau
503	SERVICE_UNAVAILABLE	Chúng tôi tạm thời đang không hoạt động để bảo trì. Xin vui lòng thử lại sau