Редактирует нескольких курьеров

  1. HTTP-запрос
  2. Path-параметры
  3. Тело запроса
    1. Представление
    2. Поля
  4. Ответы
    1. Код 200
    2. Код 401
    3. Код 403
    4. Код 404
    5. Код 422
    6. Код 504

Добавляет информацию о новых курьерах в базу данных или обновляет информацию о существующих при совпадении их номеров.

HTTP-запрос

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

Path-параметры

company_id *

integer

ID компании, используемый в запросах к API Мониторинга.

company_id *

integer

ID компании, используемый в запросах к API Мониторинга.

Тело запроса

[
  {
    "allow_manual_depot_detection": boolean,
    "allow_manual_order_detection": boolean,
    "allowed_courier_position_sources": [
      string
    ],
    "company_id": integer,
    "id": integer,
    "name": string,
    "number": string,
    "phone": string,
    "sms_enabled": boolean
  }
]
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

allow_manual_depot_detection

boolean

Указывает, разрешена ли курьеру ручная детекция посещения складов.

allow_manual_order_detection

boolean

Указывает, разрешена ли курьеру ручная детекция посещения заказов.

allowed_courier_position_sources[]

array

Список разрешённых источников данных курьерских позиций.

company_id

integer

ID компании, используемый в запросах к API Мониторинга.

id

integer

ID курьера, используемый в запросах к API Мониторинга.

name

string

Имя курьера.

number

string

Номер курьера, совпадающий с номером в учетной системе компании, выполняющей доставку.

phone

string

Телефон курьера в формате +7XXXXXXXXXX. Для каждого курьера можно указать только один номер телефона.

sms_enabled

boolean

Указывает, будут ли клиенты получать SMS-уведомления. Значение true означает, что для заказов, доставляемых этим курьером, отправляется SMS-уведомление.

allow_manual_depot_detection

boolean

Указывает, разрешена ли курьеру ручная детекция посещения складов.

allow_manual_order_detection

boolean

Указывает, разрешена ли курьеру ручная детекция посещения заказов.

allowed_courier_position_sources[]

array

Список разрешённых источников данных курьерских позиций.

company_id

integer

ID компании, используемый в запросах к API Мониторинга.

id

integer

ID курьера, используемый в запросах к API Мониторинга.

name

string

Имя курьера.

number

string

Номер курьера, совпадающий с номером в учетной системе компании, выполняющей доставку.

phone

string

Телефон курьера в формате +7XXXXXXXXXX. Для каждого курьера можно указать только один номер телефона.

sms_enabled

boolean

Указывает, будут ли клиенты получать SMS-уведомления. Значение true означает, что для заказов, доставляемых этим курьером, отправляется SMS-уведомление.

Ответы

Код 200

Информация о курьерах зарегистрирована в базе данных или обновлена.

Код 401

Ошибка авторизации. Убедитесь, что заголовок запроса содержит правильный OAuth-токен.

Код 403

Ошибка доступа к объекту. У пользователя недостаточно прав для доступа к объекту.

Код 404

Ошибка поиска объекта. Объект не найден.

Код 422

Неверный ввод. Операция не может быть выполнена.

Код 504

Ошибка при работе с API. Повторите запрос.