Phiên bản: 3.0.0

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ụ hoặc Lấy thông tin chi tiết của dịch vụ
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ại	Group ID (BIKE)	Group ID (TRUCK)
TIER	BULKY	-
BOOLEAN	D2D, FRAGILE, SMS, BAGA	CHUYENNHA, ELECTRONIC_DOCUMENT, RETURNDOC, HELPER
PER_UNIT	TIP	TIP, PHICHO
COD_INSURANCE	INSURANCE	INSURANCE
COMMISSION_DISTANCE_PERCENTAGE	TRIP	ROUND-TRIP
MULTI_OPTIONS	-	LOADING-OPTIONS

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

Type	Kích thước	Cân nặng	Mức phí
TIER_2	60x50x60	40kg	10.000 VND
TIER_3	70x60x70	60kg	20.000 VND
TIER_4	90x70x90	80kg	40.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": "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": "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": "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": "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": "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
        }
    ]
}

`MULTI_OPTIONS`

MULTI_OPTIONS là loại của Dịch vụ Phí Bốc xếp đối với các dịch vụ Xe tải, Partner sẽ chọn hình thức bốc xếp thông qua các options

options	selected_value	Mô tả
BOCXEP_RANGES	BACK_VEHICLE RANGE_20M RANGE_50M	Phạm vi hỗ trợ bốc xếp (tính từ đuôi xe) - BACK_VEHICLE: Tại đuôi xe - RANGE_20M: cách 20 mét - RANGE_50M: cách 50 mét
BOCXEP_SUPPORTER	-	Thêm 1 người hỗ trợ
BOCXEP_UPSTAIRS	-	Lên 1 lầu

path_index = 0 => Tương ứng với thêm dịch vụ bốc xếp tại Điểm lấy hàng
path_index = 1,2,3,.. => Tương ứng với thêm dịch vụ bốc xếp tại Điểm giao hàng 1,2,3,...

# 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": "21 Nguyễn Trung Ngạn, Bến Nghé, Quận 1, Hồ Chí Minh, Vietnam",
            "name": "Bao",
            "mobile":"84xxxxxxxxx",
            "cod": 10000000
        }
    ],
    "service_id": "SGN-VAN-500",
    "requests": [
        {
            "_id": "SGN-VAN-500-LOADING-OPTIONS",
            "options":[
                  {
                     "code":"BOCXEP_RANGES",
                     "selected_value":"RANGE_20M"
                  },
                  {
                     "code":"BOCXEP_SUPPORTER"
                  },
                  {
                     "code":"BOCXEP_UPSTAIRS"
                  }
            ],
            "path_index":0,
            "num":1
        },
        {
            "_id": "SGN-VAN-500-LOADING-OPTIONS",
            "options":[
                  {
                     "code":"BOCXEP_RANGES",
                     "selected_value":"RANGE_50M"
                  },
                  {
                     "code":"BOCXEP_SUPPORTER"
                  }
            ],
            "path_index":1,
            "num":1
        }
    ],
    "payment_method": "CASH",
    "items": [
        {
            "_id": "SF",
            "num": 1,
            "name": "Sofa",
            "price": 32000000
        }
    ]
}

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

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

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

TIER​

BOOLEAN, COMMISSION_DISTANCE_PERCENTAGE​

PER_UNIT​

COD_INSURANCE​

MULTI_OPTIONS​