Nhảy tới nội dung

Lấy danh sách các yêu cầu đặc biệt

Tính khả dụng của các yêu cầu đặc biệt có thể khác nhau tùy thuộc vào loại dịch vụ đang được sử dụng và khu vực giao hàng

Làm sao để lấy các yêu cầu đặc biệt?​

  • Buớc 1: Gọi API Lấy danh sách các dịch vụ
curl -X GET \
  'https://apistg.ahamove.com/v1/order/service_types?token=<TOKEN_STG>&user_mobile=84xxxxxxxxx&city_id=SGN' \
  -H 'cache-control: no-cache'
  • Buớc 2: Kiểm tra truờng thông tin requests trong kết quả trả về và xem danh sách các loại yêu cầu đặc biệt đang có của mỗi loại dich vụ

Các loại yêu cầu đặc biệt​

LoạiGroup ID
TIERBULKY
BOOLEAND2D, FRAGILE, SMS
PER_UNITTIP
COD_INSURANCEINSURANCE
COMMISSION_DISTANCE_PERCENTAGETRIP

Params mẫu khi tạo đơn hàng với nhóm loại yêu cầu​

TIER​

Để dùng loại này, Đối tác cần xem danh sách tiêu chuẩn hàng hóa của các mức độ cồng kềnh tier_list trong yêu cầu đặc biệt

Bảng quy đổi kích thước và mức cồng kềnh

TypeKích thướcCân nặngMức phí
TIER_260x50x6040kg10.000 VND
TIER_370x60x7060kg20.000 VND
TIER_490x70x9080kg40.000 VND
# 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",
            "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",
            "cod": 570000
        }
    ],
    "service_id": "SGN-BIKE",
    "requests": [
        {
            "_id": "SGN-BIKE-BULKY",
            "tier_code": "TIER_2"
        }
    ],
    "remarks": "Call me when arrived",
    "payment_method": "CASH",
}

BOOLEAN, COMMISSION_DISTANCE_PERCENTAGE​

Loại này chỉ cần có truờng thông tin _id ở mỗi yêu cầu khi tạo đơn

# 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",
            "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",
            "cod": 570000
        }
    ],
    "service_id": "SGN-BIKE",
    "requests": [
        {
            "_id": "SGN-BIKE-D2D"
        },
        {
            "_id": "SGN-BIKE-ROUND-TRIP"
        }
    ],
    "remarks": "Call me when arrived",
    "payment_method": "CASH",
}

PER_UNIT​

Với loại yêu cầu này, cần phải thêm truờng thông tin num vào mỗi requests khi truyền để cụ thể số lượng các yêu cầu được thêm vào

# 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",
            "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",
            "cod": 570000
        }
    ],
    "service_id": "SGN-BIKE",
    "requests": [
        {
            "_id": "SGN-BIKE-TIP",
            "num": 2
        }
    ],
    "remarks": "Call me when arrived",
    "payment_method": "CASH",
}

COD_INSURANCE​

  • Nếu order.cod > 0 => sử dụng giá trị của trường thông tin path[i].cod để tính Bảo hiểm hàng hóa
# 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",
            "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",
            "cod": 3200000
        }
    ],
    "service_id": "SGN-BIKE",
    "requests": [
        {
            "_id": "SGN-BIKE-INSURANCE"
        }
    ],
    "payment_method": "CASH",
    "items": [
        {
            "_id": "TN",
            "num": 1,
            "name": "Tai nghe Blutooth",
            "price": 3200000
        }
    ]    
}
  • Nếu order.cod = 0 => phải có giá trị của trường thông tin path[i].item_value để tính Bảo hiểm hàng hóa
# 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",
            "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",
            "cod": 0,
            "item_value":3200000
        }
    ],
    "service_id": "SGN-BIKE",
    "requests": [
        {
            "_id": "SGN-BIKE-INSURANCE"
        }
    ],
    "payment_method": "CASH",
    "items": [
        {
            "_id": "TN",
            "num": 1,
            "name": "Tai nghe Blutooth",
            "price": 3200000
        }
    ]
}