Редактирует курьера

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

Обновляет информацию о курьере по его ID.

HTTP-запрос

PATCH https://courier.yandex.ru/api/v1/companies/{company_id}/couriers/{courier_id}

Path-параметры

company_id *

integer

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

courier_id *

integer

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

company_id *

integer

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

courier_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

Информация о курьере обновлена.

{
  "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-уведомление.

Код 401

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

Код 403

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

Код 404

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

Код 410

Объект был удалён.

Код 422

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

Код 504

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