Create Order

cURL
JavaScript

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-BIKE' \
    --data-urlencode 'payment_method=CASH' \
    --data-urlencode 'promo_code=KHUYENMAI' \
	--data-urlencode 'remarks=This is note for order' \
    --data-urlencode 'order_time=0' \
    --data-urlencode 'requests=[{"_id":"SGN-BIKE-TIP","num":2}]' \
    --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":85000,"tracking_number":"1234"}]' \
    --data-urlencode 'items=[{"_id": "TS","num": 2,"name": "Sua tuoi","price": 15000},{"_id": "ST","num": 2,"name": "Sinh to","price": 30000}]' \
	--data-urlencode 'token=<TOKEN_STG>'

var myHeaders = new Headers();
myHeaders.append('accept', 'application/json');
myHeaders.append('content-type', 'application/x-www-form-urlencoded');

var urlencoded = new URLSearchParams();
urlencoded.append('service_id', 'SGN-BIKE');
urlencoded.append('payment_method', 'CASH');
urlencoded.append('promo_code', 'KHUYENMAI');
urlencoded.append('remarks', 'This is note for order');
urlencoded.append('order_time', '0');
urlencoded.append('requests', '[{"_id":"SGN-BIKE-TIP","num":2}]');
urlencoded.append(
	'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":85000,"tracking_number":"1234"}]'
);
urlencoded.append("items", "[{"_id": "TS","num": 2,"name": "Sua tuoi","price": 15000},{"_id": "ST","num": 2,"name": "Sinh to","price": 30000}]");
urlencoded.append('token', '<TOKEN_STG>');
urlencoded.append('conversion_data', '');

var requestOptions = {
	method: 'POST',
	headers: myHeaders,
	body: urlencoded,
	redirect: 'follow',
};

fetch('https://apistg.ahamove.com/v1/order/create', requestOptions)
	.then((response) => response.text())
	.then((result) => console.log(result))
	.catch((error) => console.log('error', error));

Create a new order by user (support both GET/POST method)

HTTP Request

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

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": 85000,
			"tracking_number": "1234"
        }
    ],
    "service_id": "SGN-BIKE",
    "requests": [
		{
        "_id": "SGN-BIKE-TIP",
        "num": 2
        }
	],
    "images": [],
    "promo_code": "KHUYENMAI",
    "remarks": "Call me when arrived",
    "payment_method": "CASH",
    "items": [
        {
            "_id": "TS",
            "num": 2,
            "name": "Sua tuoi",
            "price": 15000
        },
        {
            "_id": "ST",
            "num": 2,
            "name": "Sinh to lua mach",
            "price": 30000
        }
    ]
}

Parameter	Type	Required	Description
token	String	Yes	The user Token.
order_time	Number (Unix timestamp)	Yes	The pickup time. Set 0 to pickup ASAP.
path	String	Yes	At least 2 pairs (described in more detail below).
service_id	String	Yes	Ahamove Service ID (SGN-BIKE, SGN-POOL, etc.).
requests	Array	Yes	JSONArray representing Special Requests.
payment_method	String	Yes	Payment method chosen by user - `BALANCE`: Payment through the Ahamove account of the user - `CASH`: Payment in cash by the Sender - `CASH_BY_RECIPIENT`: Payment in cash by the Recipient
images	Array	No	JSONArray representing image urls.
promo_code	String	No	Promo code to discount shipping fee.
remarks	String	No	Remarks.
idle_until	Number (Unix timestamp)	Yes	The broadcast time. Set `idle_until=order_time` if order_time > 0. Optional if `order_time` is 0.
items	Array	No	JSONArray representing items (for Food Partners)
type	String	No	Order type, for eg: warehouse, etc … Treat as normal flow incase type is not specified
need_optimize_route	Boolean	No	In case, if partner need Ahamove to optimize route (1 pickup, > 2 drop off points)

Path

Representing From path[0] and multiple Tos path[x], x > 0

Parameter	Type	Required	Description
address	String	Yes	Address of the location.
lat	Number	Yes	Latitude of the location (Optional but highly recommended).
lng	Number	Yes	Longitude of the location (Optional but highly recommended).
name	String	Yes	Recipient's name. Optional if is `path[0]`.
mobile	String	Yes	Recipient's mobile number. Optional if is `path[0]`.
tracking_number	String	No	Tracking number for the package (Partner's internal order id, not required but Ahamove highly recommended having this field in `path[x]`).
remarks	String	No	Note to supplier, for multiple delivery points.
cod	Number	No	COD amount (Cash on delivery)
require_pod	Boolean	No	If true, supplier will be required proof of delivery before complete the transaction
building	String	No	Building name for delivery to door
apt_number	String	No	Apartment, Suite or Floor number for delivery to door

Note

lat and lng is not required but address field in parameters needs to have correct information as shown in the format below

[House number] [Street name], [Ward], [District], [Province/City], Việt nam

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

Some types of Invalid Address :

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

Response

JSON response example:

{
	"order_id": "USAGND",
	"status": "ASSIGNING",
	"shared_link": "https://cloudstg.ahamove.com/share-order/USAGND/84909055578",
	"order": {
		"_id": "USAGND",
		"currency": "VND",
		"user_main_account": 0,
		"user_bonus_account": 0,
		"total_pay": 33000,
		"distance": 1.02,
		"duration": 268,
		"distance_fee": 23000,
		"request_fee": 10000,
		"stop_fee": 0,
		"vat_fee": 0,
		"discount": 0,
		"path": [
			{
				"address": "Nhà Thờ Đức Bà, Vietnam",
				"lat": 10.7797855,
				"lng": 106.6990189
			},
			{
				"address": "Chợ Bến Thành, Vietnam",
				"lat": 10.7725451,
				"lng": 106.6980413
			}
		],
		"from_location": {
			"type": "Point",
			"coordinates": [106.6990189, 10.7797855]
		},
		"requests": [
			{
				"_id": "SGN-BIKE-TIP",
				"num": 2
			}
		],
		"items": [],
		"total_fee": 33000,
		"remarks": "This is note for order",
		"app": "Ahamove",
		"service_id": "SGN-BIKE",
		"city_id": "SGN",
		"user_id": "84xxxxxxxxx",
		"user_name": "TEST CREATE AN ORDER",
		"user_imei": null,
		"create_time": 1565577713.2757928,
		"order_time": 1565577713.2757928,
		"index": 12,
		"status": "ASSIGNING",
		"partner": "TESTPARTNER",
		"polylines": "ukx`A}rfjS~CuDhHnGlBnA|DoEdFcB|BhBxBtDzBmA",
		"online_pay": 0,
		"notify_package_return": true,
		"uniform_user_feedback": 2,
		"pending_period": 100,
		"stoppoint_price": 0,
		"special_request_price": 10000,
		"vat": 0,
		"distance_price": 23000,
		"voucher_discount": 0,
		"subtotal_price": 33000,
		"total_price": 33000
	}
}

Status-Code: 200 OK

Errors

Code	Text	Description
`400`	`INVALID_ADDRESS`	Invalid Address
`404`	`Not Found`	- Token not found (Token has expired. When a new token is created, the old token has expired) - Path not found - Service not found
`406`	`Not Acceptable`	- Booking time not valid - Address not valid - Request not valid - Distance not valid - Invalid pickup area - Invalid delivery area - Concurrent order not allowed (If partner not in token) - Large COD not allowed for first time user - Post paid not set for partner - Not supported payment method - Not enough credit - User’s phone number associated with - Token has been used for a partner - Child order status not valid (When creating parent order) - Parent order existed for #ABCXYZ (When creating a parent order but child orders already had a parent) - Idle until not valid (When client sent idle_until < current_time) - COD is not valid ( When total COD exceeds the maximum value which was configured in service) - Number of stop points are not valid
`408`	`Request timeout`	Google Distance API does not return results in 10 seconds.
`409`	`Conflict`	- New order not allow (Not allow 2 consecutive orders in 1 minute) - Tracking number duplicated (Not allow to create duplicated tracking number within 60s)
`500`	`Internal Server Error`	We had a problem with our server. Try again later.
`503`	`Service Unavailable`	We're temporarily offline for maintenance. Please try again later.

Create Order

HTTP Request​

Parameters​

Path​

Note​

Response​

Errors​