Edits multiple routes

Adds information about new routes to the database or updates information about existing routes if their numbers match.

Request

POST

https://courier.yandex.ru/api/v1/companies/{company_id}/routes-batch

Path parameters

Name

Description

company_id*

Type: integer<int64>

Company ID used in requests to the Track & Trace API.

Body

application/json

[
    {
        "custom_fields": [
            {
                "key": "string",
                "value": "string"
            }
        ],
        "date": "string",
        "id": 0,
        "imei": 0,
        "rented_courier_id": "string",
        "imei_str": "string",
        "number": "string",
        "route_start": "string",
        "route_finish": "string",
        "routing_mode": "string",
        "tracking_start_h": 0,
        "courier_id": 0,
        "courier_number": "string",
        "depot_id": 0,
        "depot_number": "string"
    }
]

RouteModify[]

RouteModify

Name	Description
courier_id	Type: integer<int64> ID of the courier who delivers items on the route. The request must specify the `courier_id` or `courier_number`. If both `courier_id` or `courier_number` are specified `courier_number` is used.
courier_number	Type: string Mobile employee number. Used for syncing with the delivery company's system. The request must specify the `courier_id` or `courier_number`. If both `courier_id` or `courier_number` are specified `courier_number` is used.
custom_fields	Type: CustomField[] List of route custom fields. Max number of custom fields is 10. Min items: `0` Max items: `10`
date	Type: string<date> The date of the route in YYYY-MM-DD format. Cannot be changed if there are orders on route.
depot_id	Type: integer<int64> ID of the depot where the route starts. The request must specify the `depot_id` or `depot_number` parameter. If both `depot_id` or `depot_number` are specified `depot_number` is used.
depot_number	Type: string Depot number. Used for syncing with the delivery company's system. The request must specify the `depot_id` or `depot_number` parameter. If both `depot_id` or `depot_number` are specified `depot_number` is used.
id	Type: integer Route ID used in requests to the Track & Trace API.
imei	Type: integer The number of the GPS tracker installed on the vehicle on the route.
imei_str	Type: string String representation of numeric number of a GPS tracker. Should be used in case integer overflow of numeric number of a GPS tracker value in the programming language used. If defined in request, this takes precedence over the value of integer number of a GPS tracker field.
number	Type: string Route number. Used for syncing with the delivery company's system.
rented_courier_id	Type: string Rented courier ID used in requests to the Track & Trace API.
route_finish	Type: string Route finish time relative to the `date` value, in the [d.]HH:MM:SS format. If specified, positions sent by GPS trackers and the app will be recorded only before the specified time.
route_start	Type: string Route start time relative to the `date` value, in the [d.]HH:MM:SS format. If specified: Positions sent by GPS trackers and the app will be recorded only after `route_start - tracking_start_h`. Order history START event will be added to order history only after the specified time. Order status change SMS notification messages, if enabled, will be sent to clients only after the specified time.
routing_mode	Type: string Transportation method. Possible values: `driving` - courier drives a car. `truck` - courier drives a truck. `transit` - courier uses public transport and walks. `walking` - courier walks.
tracking_start_h	Type: integer<int32> Route tracking will start `tracking_start_h` hours before route start. If `route.route_start` is specified, positions sent by GPS trackers and the app will be recorded only after `route.route_start - route.tracking_start_h` if `route.tracking_start_h` is specified, otherwise after `route.route_start - company.tracking_start_h`. Min value: `0` Max value: `24`

CustomField

Name

Description

key

Type: string

Key of custom field. Must correspond to one of route custom fields in company settings.

Max length: 255

value

Type: string

Value of custom field.

Max length: 255

Responses

200 OK

Information about routes was registered or updated in the database.

401 Unauthorized

Authorization error. Make sure that the request header contains the correct OAuth token.

403 Forbidden

Error accessing the object. The user doesn't have the rights to access the object.

404 Not Found

Object search error. Object not found.

422 Unprocessable Entity

Incorrect input. The operation can't be performed.

504 Gateway Timeout

Error working with the API. Repeat the request.

Was the article helpful?

Adds a route

Deletes route