Nhảy tới nội dung

Tạo đơn Warehouse

Tạo đơn hàng mới dịch vụ Warehouse

curl --request POST \
    --url https://apistg.ahamove.com/v1/order/create \
    --header 'Cache-Control: no-cache' \
    --header 'accept: application/json' \
    --header 'content-type: application/x-www-form-urlencoded' \
    --data-urlencode 'service_id=SGN-WAREHOUSE' \
    --data-urlencode 'payment_method=BALANCE' \
    --data-urlencode 'remarks=This is note for order' \
    --data-urlencode 'order_time=0' \
    --data-urlencode 'path=[{"lat":10.7692105,"lng":106.6637935,"address":"725 Hẻm số 7 Thành Thái, Phường 14, Quận 10, Hồ Chí Minh, Việt Nam","short_address":"Quận 10","name":"nmbmb","mobile":"84xxxxxxxxx"},{"lat":10.7828887,"lng":106.704898,"address":"Miss Ao Dai Building, 21 Nguyễn Trung Ngạn, Bến Nghé, Quận 1, Hồ Chí Minh, Vietnam","name":"Bao","mobile":"84xxxxxxxxx","remarks":"call me","cod":520000,"item_value":830000,"weight":28,"height":42,"width":30,"length":64,"tracking_number":"ABCXXXXXXXX"}]' \
    --data-urlencode 'items=[{"_id": "DG","num": 2,"name": "Combo dầu gội và sữa tắm Dove","price": 520000},{"_id": "ST","num": 1,"name": "Thùng sữa tươi Vinamilk","price": 310000}]' \
    --data-urlencode 'token=<TOKEN_STG>'

HTTP Request​

POST https://apistg.ahamove.com/v1/order/create (x-wwww-form-urlencoded)

or

GET https://apistg.ahamove.com/v1/order/create

Parameters​

# Parameters
{
    "order_time": 0,
    "path": [
        {
            "lat": 10.7692105,
            "lng": 106.6637935,
            "address": "725 Hẻm số 7 Thành Thái, Phường 14, Quận 10, Hồ Chí Minh, Việt Nam",
            "short_address": "Quận 10",
            "name": "nmbmb",
            "mobile":"84xxxxxxxxx"
        },
        {
            "lat": 10.7828887,
            "lng": 106.704898,
            "address": "Miss Ao Dai Building, 21 Nguyễn Trung Ngạn, Bến Nghé, Quận 1, Hồ Chí Minh, Vietnam",
            "name": "Bao",
            "mobile":"84xxxxxxxxx",
            "remarks": "call me",
            "cod": 520000,
            "tracking_number": "ABCXXXXXXXX",
            "weight": 28,
            "height": 42,
            "width": 30,
            "length": 64,
            "item_value": 830000
        }
    ],
    "service_id": "SGN-WAREHOUSE",
    "remarks": "This is note for order",
    "payment_method": "BALANCE",
    "items": [
        {
            "_id": "DG",
            "num": 2,
            "name": "Combo dầu gội và sữa tắm Dove",
            "price": 520000
        },
        {
            "_id": "ST",
            "num": 1,
            "name": "Thùng sữa tươi Vinamilk",
            "price": 310000
        }
    ]
}
ParameterTypeYêu cầuMô tả
tokenStringCóToken của người dùng. Lấy token bằng API Đăng ký tài khoản
order_timeNumber (Unix timestamp)CóThời gian lấy hàng (order_time = 0)
pathStringCóÍt nhất 2 phần (được mô tả chi tiết hơn ở bên dưới)
service_idStringCóMã dịch vụ Warehouse, hiện có ở 2 tỉnh thành là TP.Hồ Chí Minh (SGN-WAREHOUSE) và Hà Nội (HAN-WAREHOUSE)
payment_methodStringCóPhương thức thanh toán dùng cho dịch vụ Warehouse là BALANCE
remarksStringKhôngChú thích
itemsArrayKhôngDãy JSON thể hiện cho các mặt hàng (Đối với các Đối tác ngành hàng thực phẩm)

Path​

Hiển thị từ path[0] đến path[1]

ParameterTypeYêu cầuMô tả
addressStringCóĐịa chỉ
latNumberCóVĩ độ của địa điểm (Không bắt buộc nhưng đề xuất Đối tác nên sử dụng)
lngNumberCóKinh độ của địa điểm (Không bắt buộc nhưng đề xuất Đối tác nên sử dụng)
nameStringCóTên người gửi/người nhận
mobileStringCóSố điện thoại người gửi/người nhận
tracking_numberStringCóMã đơn hàng nội bộ của Đối tác, ít nhất 6 kí tự, không chứa kí tự đặc biệt (_,-,.,/,...) và là mã duy nhất. Mã này cần được in trên gói hàng
weightFloatCóKhối lượng thực tế của gói hàng (Kg)
heightFloatCóChiều cao thực tế của gói hàng (cm)
lengthFloatCóChiều dài thực tế của gói hàng (cm)
widthFloatCóChiều rộng thực tế của gói hàng (cm)
item_valueNumberCóGiá trị thực tế của gói hàng
codNumberKhôngSố tiền COD cần thu từ người nhận
remarksStringKhôngChú thích dành cho tài xế

Lưu ý​

lat và lng là không bắt buộc nhưng trường address trong parameters cần phải đầy đủ thông tin và theo đúng định dạng như bên dưới:

[Số nhà] [Tên đường], [Phường/Xã], [Quận/Huyện], [Tỉnh/Thành], Việt Nam

Ví dụ: 117 Hùng Vương, Phường 4, Quận 5, Thành phố Hồ Chí Minh, Việt Nam
hoặc 117 Hùng Vương, Phường 4, Quận 5, Hồ Chí Minh

Các yêu cầu về địa chỉ khi truyền sang Ahamove​

  1. Địa chỉ rõ ràng, các phần thông tin cách nhau bởi dấu phẩy
  2. Địa chỉ có thể tìm được trên google map (Có thể dùng luôn google plus code)
  3. Địa chỉ không trùng lập các thông tin Phường/Quận/Tỉnh (Đối với các Đối tác cho Khách hàng chọn địa chỉ theo dạng dropdown)

Một số dạng Địa chỉ không hợp lệ :​

  • 658 võ văn kiệt p1 Quận 5 Hồ Chí Minh
  • 58 Nghĩa Thục - Phường 5 - Quận 5 - Hồ Chí Minh - Việt Nam
  • 22 Bùi Hữu Nghĩa
  • 60/62 chiêu anh các
  • 930 vo văn Kiệt p5q5
  • Có ji e gởi đia chỉ 835/17c trần hung dao p1 q5 tphcm giúp c nha, Phường 01, Quận 5, Thành phố Hồ Chí Minh
  • 54 Bạch Vân (Nhà màu xanh cuối hẻm, gọi số 0908999999), Phường 5, Quận 5, TP Hồ Chí Minh
  • 189 Trần Tuấn Khải F.5 Q.5 Ngay ngã 3 Trần Hưng Đạo
  • địa chỉ: 53 Huỳnh Mẫn Đạt phường 5 Quận 5 TP.HCM ĐT: 0912123456
  • 14/20 .an binh p5q5
  • 155 Trần Tuần Khải, p5, q5
  • Số 1 bạch Vân phường 5 quận 5 TPHCM
  • đc hẻm 93/107/16 đường bạch vân p5 q5
  • 112 An Bình P5, Quận 5, HCM
  • 1025, Phường 5, Quận 5

Items​

Trường thông tinTypeYêu cầuMô tả
_idStringCóMã sản phẩm
nameStringCóTên sản phẩm
priceIntCóTổng giá trị sản phẩm sau khi đã nhân với số lượng
numIntCóSố lượng sản phẩm

Response​

JSON response example:

{
    "_id": "PARTNER_ABCXXXXXXXX",      # Mã đơn hàng Warehouse, được tạo bởi tên partner và mã tracking_number
    "tracking_number": "ABCXXXXXXXX",
    "status": "VERIFYING"       # Với mỗi đơn hàng Warehouse được tạo thành công sẽ có được trả về trạng thái là VERIFYING
}

Status-Code: 200 OK

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

Mã lỗiNội dungMô tả
404Not Found- Không tìm thấy token (Token hết hạn. Khi token mới được tạo thì token cũ sẽ bị hết hạn)
- Không tìm thấy path
- Không tìm thấy dịch vụ
406Not Acceptable- Thời gian đặt hàng không hợp lệ
- Địa chỉ không hợp lệ
- Trùng mã theo dõi
- Khoảng cách không hợp lệ
- Khu vực lấy hàng không hợp lệ
- Khu vực giao hàng không hợp lệ
- Các đơn hàng đồng thời không được cho phép (Nếu Đối tác không có trong token)
- Không cho phép số lượng COD quá lớn cho người dùng lần đầu tiên
- Đối tác không được đặt công nợ
- Không hỗ trợ phương thức thanh toán này
- Không đủ tiền
- Số điện thoại của người dùng không được liên kết
- Token đã được dùng cho một đối tác
- Trạng thái đơn con không hợp lệ (Khi tạo đơn cha)
- Đơn cha đã tồn tại #ABCXYZ (Khi tạo một đơn cha nhưng đơn con lại thuộc tài khoản cha khác)
- Thời gian hẹn giờ không hợp lệ (Khi khách hàng gửi idle_until < current_time)
- COD không hợp lệ ( Khi tổng COD vượt quá giá trị tối đa đã được cấu hình trong dịch vụ )
- Số điểm dừng không hợp lệ
408Request timeoutGoogle Distance API không trả về kết quả trong 10 giây
500Internal Server ErrorHệ thống của chúng tôi có lỗi xảy ra. Xin thử lại sau
503Service UnavailableChúng tôi tạm thời đang không hoạt động để bảo trì. Xin vui lòng thử lại sau
Cập nhật lần cuối vào bởi thangden