Добавление курьеров
После добавления складов нужно добавить в базу данных список курьеров, выполняющих заказы.
Примечание
Для работы с API Мониторинга нужно использовать ID компании. Если у вас нет ID, напишите нам.
Через интерфейс Рабочего места логиста
-
Откройте Рабочее место логиста.
-
В меню слева выберите Мониторинг → Курьеры.
-
Введите информацию о каждом курьере — номер телефона и логин, и нажмите Добавить.
Если в качестве логина вы укажете номер мобильного телефона курьера в формате
+7хххххххххх, то курьеру не придется вводить логин для авторизации в приложении Яндекс Курьер.Регистрация курьеров описана в разделе Работа со списком курьеров.
-
В меню слева выберите Настройки → Мобильное приложение.
-
Введите номера телефонов курьеров и нажмите Добавить. Эти курьеры смогут использовать приложение Яндекс Курьер.
Добавление курьеров описано в разделе Курьеры.
Через API
Примечание
При добавлении курьера через API можно указать не только номер телефона phone и логин number, но и имя name.
Отправьте запрос к ресурсу couriers-batch. В запросе укажите информацию о сотрудниках.
Для отправки API-запросов через Postman вы можете использовать коллекцию Routing API.
Внимание
В спецификации указаны обязательные поля для уже существующих объектов, для новых этот список шире. При добавлении новых объектов через запрос к ресурсу couriers-batch заполните поля, указанные как обязательные при запросе к ресурсу couriers.
Запрос:
cURL
curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X POST -d @<Путь_до_файла_в_кодировке_UTF-8> https://courier.yandex.ru/api/v1/companies/<id-вашей-компании>/couriers-batch
Файл
[
{
"number":"222",
"phone":"+71234524423",
"name":"Ваня"
},
{
"number":"224",
"phone":"+71234553425",
"name":"Олеся"
}
]
cURL
curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-OAuth-токен>" -X POST -d '[{"number":"222", "phone":"+71234524423", "name":"Ваня"}, {"number":"224", "phone":"+71234553425", "name":"Олеся"}]' https://courier.yandex.ru/api/v1/companies/<id-вашей-компании>/couriers-batch
Результат:
{
"inserted": 2,
"updated": 0
}
Номера телефонов курьеров для приложения Яндекс Курьер
Если курьеры используют приложение Яндекс Курьер, нужно добавить их номера в базу данных, иначе они не смогут пользоваться приложением.
Через интерфейс Рабочего места логиста
-
Откройте Рабочее место логиста.
- В меню слева выберите Настройки → Мобильное приложение.
- Введите номер телефона курьера и нажмите Добавить.
Можно добавлять сразу несколько номеров курьеров. Для этого напишите номера телефонов через запятую.
Через API
Отправьте запрос к ресурсу app-user. В запросе укажите номер телефона курьера в формате E.164, например +79012345678.
Для отправки API-запросов через Postman вы можете использовать коллекцию Routing API.
Запрос:
cURL
curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X POST -d @<Путь_до_файла_в_кодировке_UTF-8> https://courier.yandex.ru/api/v1/companies/<id-вашей-компании>/app-user
Файл
{
"login":"+79012345678"
}
cURL
curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-OAuth-токен>" -X POST -d '{"login":"+79012345678"}' https://courier.yandex.ru/api/v1/companies/<id-вашей-компании>/app-user
Результат:
{}