route_update

To create, edit, or delete a route, or to move it to history, use the order/route_update method.

svc=order/route_update&params={
  "itemId": <long>,
  "orders": [],
  "routeId": <long>,
  "callMode": "<text>"
}

The required parameters are marked with an asterisk (*).

With delete, the method deletes only the route. Its orders stay in the resource unless you pass them in orders with "callMode": "delete".

With register, the method moves the route and its orders to history. To get them from history, use order/get_routes_history and order/get_orders_history.

With purge, the method deletes the route and all its orders without validating them. The orders are taken from the route itself, so you don’t need to pass them. If a route with the specified ID doesn’t exist, the method doesn’t return an error.

For create, update, and delete, the result is similar to the batch of order/update.

For create, update, and delete, the response is returned in the following format:

{
	"orders":[{
		"id":<uint>,		/* order ID */ 
		"f":<uint>,		/* order flags */
		"u":<uint>,		/* unit ID */
		"uid":<uint>,		/* order UID */
		"callMode":"<text>"
	},
	...
	]
}

For register and purge, the response is an empty object {}.

If the request fails, an error code is returned.