Thay đổi thông tin đơn hàng

Cho phép người dùng thay đổi thông tin đơn hàng sau khi đã tạo đơn

Các điều kiện của đơn hàng cho phép cập nhật thông tin

• Trạng thái cho phép cập nhật: IDLE, ASSIGNING, ACCEPTED
• Các trường thông tin cho phép cập nhật trong path:

Parameter	Số lần được cập nhật	Dịch vụ cho phép cập nhật	Path cho phép cập nhật	Phương thức thanh toán cho phép cập nhật
name	Không giới hạn	Dịch vụ Ahamove và OnWheel (VNM-PARTNER-XXX)	Path điểm lấy hàng và giao hàng	BALANCE, CASH, CASH_BY_RECIPIENT
mobile	Không giới hạn	Dịch vụ Ahamove và OnWheel	Path điểm lấy hàng và giao hàng	BALANCE, CASH, CASH_BY_RECIPIENT
remarks	Không giới hạn	Dịch vụ Ahamove và OnWheel	Path điểm lấy hàng và giao hàng	BALANCE, CASH, CASH_BY_RECIPIENT
cod	1 lần cho từng path	Dịch vụ OnWheel	Path điểm giao hàng	BALANCE, CASH
address	1 lần cho từng path	Dịch vụ OnWheel	Path điểm giao hàng	BALANCE, CASH

cURL

curl --location --request PATCH 'https://partner-apistg.ahamove.com/v3/orders/<order_id>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "path_index": 1,
    "name": "Anh",
    "mobile": "09xxxxxxxx",
    "remarks": "Cổng đón khách A",
    "cod": 220000,
    "address_info": {
        "lat": 10.798026,
        "lng": 106.696369,
        "address": "Bệnh Viện Quận Bình Thạnh, 132 Lê Văn Duyệt, Phường 1, Quận Bình Thạnh, Thành phố Hồ Chí Minh, Việt Nam"
    }
}'

JavaScript

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

const raw = JSON.stringify({
  path_index: 1,
  name: 'Anh',
  mobile: '09xxxxxxxx',
  remarks: 'Cổng đón khách A',
  cod: 220000,
  address_info: {
    lat: 10.798026,
    lng: 106.696369,
    address:
      'Bệnh Viện Quận Bình Thạnh, 132 Lê Văn Duyệt, Phường 1, Quận Bình Thạnh, Thành phố Hồ Chí Minh, Việt Nam',
  },
});

const requestOptions = {
  method: 'PATCH',
  headers: myHeaders,
  body: raw,
  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

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

Headers

Parameter	Value	Yêu cầu	Mô tả
Authorization	Bearer <token>	Có	Token của người tạo đơn

Body

{
  "path_index": 1,
  "name": "Anh",
  "mobile": "09xxxxxxxx",
  "remarks": "Cổng đón khách A",
  "cod": 220000,
  "address_info": {
    "lat": 10.798026,
    "lng": 106.696369,
    "address": "Bệnh Viện Quận Bình Thạnh, 132 Lê Văn Duyệt, Phường 1, Quận Bình Thạnh, Thành phố Hồ Chí Minh, Việt Nam"
  }
}

Parameters

Parameter	Type	Required	Description
path_index	Int	Có	số thứ tự path cần cập nhật thông tin ( path_index = 0 là path điểm lấy hàng, giá trị tối đa là thứ tự của điểm giao cuối cùng )
name	String	Không	Thông tin tên, trường name trong từng path
mobile	String	Không	Thông tin số điện thoại, trường mobile trong từng path
remarks	String	Không	Thông tin ghi chú, trường remarks trong từng path
cod	Int	Không	Giá trị COD trong từng path điểm giao hàng
address_info	Object	Không	Các thông tin liên quan đến địa chỉ điểm giao hàng

Model của address_info

Cập nhật từ path[x], x > 0

Parameter	Type	Yêu cầu	Mô tả
address	String	Có	Địa chỉ giao hàng đúng định dạng
lat	Float	Không	Vĩ độ của điểm giao (Không bắt buộc nhưng đề xuất Đối tác nên sử dụng)
lng	Float	Không	Kinh độ của điểm giao (Không bắt buộc nhưng đề xuất Đối tác nên sử dụng)

Response

JSON response example:

{}

Status-Code: 200 OK

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

Mã lỗi	Nội dung	Mô tả
400	BAD_REQUEST	Dữ liệu chưa đúng
400	MISSING_REQUIRED_INFO	Thiếu các trường thông tin bắt buộc
400	INVALID_DATA	Dữ liệu truyền lên không hợp lệ
401	NOT_AUTHORIZED	Token không hợp lệ
403	SUPPLIER_NOT_ENOUGH_MONEY_FOR_CHANGE_ADDRESS	Không thể thay đổi địa chỉ giao hàng mới vì tài khoản của tài xế đang nhận đơn không đủ tiền để khấu trừ chiết khấu
403	STOP_POINT_EDITED	Đã thay đổi thông tin điểm giao
403	ORDER_STATUS_NOT_ALLOWED	Trạng thái đơn hàng không cho phép để thay đổi thông tin
403	CHANGE_ADDRESS_NOT_ALLOWED	Không cho phép thay đổi địa chỉ
404	ORDER_NOT_FOUND	Không tìm thấy đơn hàng
406	NOT_ALLOW_ORDER_WITH_PROMO_CODE	Không cho phép thay đổi thông tin đơn hàng khi đã áp dụng mã giảm giá
406	NOT_ALLOW_CHANGE_PICKUP_ADDRESS	Không cho phép thay đổi địa chỉ lấy hàng
406	INVALID_PAYMENT_METHOD	Phương thức thanh toán của đơn không được hỗ trợ thay đổi thông tin đơn hàng
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