Добавляет курьера

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

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

HTTP-запрос

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

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

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

{
  "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-токен.

Код 422

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

Код 504

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