Edits multiple orders
Adds information about new orders to the database or updates information about existing ones if their numbers match.
HTTP Request
POST https://courier.yandex.ru/api/v1/companies/{company_id}/orders-batch
Path Parameters
company_id * | integer Company ID used in requests to the Track & Trace API. |
company_id * | integer Company ID used in requests to the Track & Trace API. |
* Required parameter
Request Body
[ { "address": string, "amount": number, "comments": string, "customer_name": string, "customer_number": string, "description": string, "eta_type": string, "lat": number, "lon": number, "mark_delivered_radius": number, "notifications": [ { "type": string } ], "number": string, "payment_status": string, "payment_type": string, "phone": string, "refined_lat": number, "refined_lon": number, "route_id": integer, "route_number": string, "service_duration_s": integer, "shared_service_duration_s": integer, "shared_with_company_ids": [ number ], "shared_with_company_numbers": [ string ], "show_yandex_pay_button": boolean, "status": string, "time_interval": string, "type": string, "volume": number, "weight": number } ]
Copied to clipboard
Representation
Fields
address | string Delivery address in text format. |
amount | number Order price in rubles. |
comments | string Order comments. |
customer_name | string Recipient's name. |
customer_number | string Customer's number in the delivery company database. |
description | string Order description. |
eta_type | string ETA type. Affects the time of notification and automatic delivery detection. |
lat | number Latitude of the delivery point. |
lon | number Longitude of the delivery point. |
mark_delivered_radius | number Radius in meters. If Minimum value: |
notifications[] | array List of push notification settings. |
notifications[]. | string Notification type. Allowed values
|
number | string Order number. Used for syncing with the delivery company's system. |
payment_status | string Payment status. Possible values:
|
payment_type | string Payment method. Possible values:
|
phone | string The recipient's phone number. |
refined_lat | number Latitude of the real (refined by courier) delivery point. |
refined_lon | number Logitude of the real (refined by courier) delivery point. |
route_id | integer Route ID used in requests to the Track & Trace API. |
route_number | string Route number. Used for syncing with the delivery company's system. You must specify |
service_duration_s | integer Expected time the courier will need to pass the order to the recipient, including going up to the floor and receiving payment. |
shared_service_duration_s | integer Service duration at the location, which can be shared with other orders at the same location. |
shared_with_company_ids[] | array IDs of the companies that can access the order information. The following information is provided:
|
shared_with_company_numbers[] | array Numbers of the companies that can access the order information. The following information is provided:
|
show_yandex_pay_button | boolean Show Yandex Pay button. |
status | string The current order status. Possible values:
|
time_interval | string Desired delivery time interval. The following formats are supported:
|
type | string Type of order. Possible values |
volume | number Order volume. |
weight | number Order weight. |
address | string Delivery address in text format. |
amount | number Order price in rubles. |
comments | string Order comments. |
customer_name | string Recipient's name. |
customer_number | string Customer's number in the delivery company database. |
description | string Order description. |
eta_type | string ETA type. Affects the time of notification and automatic delivery detection. |
lat | number Latitude of the delivery point. |
lon | number Longitude of the delivery point. |
mark_delivered_radius | number Radius in meters. If Minimum value: |
notifications[] | array List of push notification settings. |
notifications[]. | string Notification type. Allowed values
|
number | string Order number. Used for syncing with the delivery company's system. |
payment_status | string Payment status. Possible values:
|
payment_type | string Payment method. Possible values:
|
phone | string The recipient's phone number. |
refined_lat | number Latitude of the real (refined by courier) delivery point. |
refined_lon | number Logitude of the real (refined by courier) delivery point. |
route_id | integer Route ID used in requests to the Track & Trace API. |
route_number | string Route number. Used for syncing with the delivery company's system. You must specify |
service_duration_s | integer Expected time the courier will need to pass the order to the recipient, including going up to the floor and receiving payment. |
shared_service_duration_s | integer Service duration at the location, which can be shared with other orders at the same location. |
shared_with_company_ids[] | array IDs of the companies that can access the order information. The following information is provided:
|
shared_with_company_numbers[] | array Numbers of the companies that can access the order information. The following information is provided:
|
show_yandex_pay_button | boolean Show Yandex Pay button. |
status | string The current order status. Possible values:
|
time_interval | string Desired delivery time interval. The following formats are supported:
|
type | string Type of order. Possible values |
volume | number Order volume. |
weight | number Order weight. |
* Required parameter
Responses
Code 200
Information about orders was registered or updated in the database.
Code 401
Authorization error. Make sure that the request header contains the correct OAuth token.
Code 403
Error accessing the object. The user doesn't have the rights to access the object.
Code 404
Object search error. Object not found.
Code 422
Incorrect input. The operation can't be performed.
Code 504
Error working with the API. Repeat the request.