Логистика и доставка
Службы доставки, грузоперевозчики и автопарки подключаются в разделе «Интеграции», вкладка «Сервисы». Общие правила (статусы карточки, строка «Изменения», второй кабинет, отключение) описаны на странице «Подключение сервисов». Заявка на перевозку, вызов курьера и команда машине меняют дела в реальном мире, поэтому что агент делает сам, а что присылает карточкой, описано в разделе «Как агент меняет данные». Каталог: Логистика.
СДЭК
Заказы, расчёт тарифов, отслеживание, пункты выдачи и вызов курьера. Сценарии на странице интеграции.
Что умеет агент
Считать тарифы, создавать заказы и вызывать курьера, отслеживать посылки и искать пункты выдачи.
Что нужно заранее
Договор со СДЭК на юрлицо или ИП. Розничный кабинет отправителя ключей не выдаёт.
Шаги
Войдите в кабинет по договору
На lk.cdek.ru войдите под учётной записью, к которой привязан договор.
Откройте «Интеграцию»
В меню кабинета выберите «Интеграция» (lk.cdek.ru/integration).
Создайте ключ
Нажмите «Создать новый ключ». Account вставьте в «ID клиента», Secure password в «Секрет клиента». Secure password показывается один раз.
Как отозвать доступ
Нажмите «Отключить» в карточке подключения и удалите ключ в разделе «Интеграция» кабинета СДЭК.
Неполадки
- Нет раздела «Интеграция»: кабинет без договора или вы вошли не под учётной записью договора.
- Secure password потерян: выпустите новый ключ и нажмите «Ввести ключи заново».
Почта России
Почтовые отправления: заказы, тарифы, трекинг, нормализация адресов и поиск отделений. Сценарии на странице интеграции.
Что умеет агент
Создавать отправления, считать тарифы, отслеживать посылки, нормализовать адреса и искать отделения.
Что нужно заранее
Кабинет на otpravka.pochta.ru с подтверждённой заявкой на доступ. Подтверждение занимает несколько рабочих дней.
Шаги
Заведите кабинет
Зарегистрируйтесь на otpravka.pochta.ru и дождитесь подтверждения заявки.
Скопируйте токен
В разделе «API» (otpravka.pochta.ru/settings#/api-settings) скопируйте «API токен» в «Токен доступа».
Укажите логин и пароль
Логин и пароль кабинета вставьте в «Имя пользователя» и «Пароль». Логин надёжнее указывать телефоном в формате +7XXXXXXXXXX.
Как отозвать доступ
Нажмите «Отключить» в карточке. Новый токен в кабинете выдаёт кнопка рядом с полем «API токен» в разделе «API».
Неполадки
- Токена нет в кабинете: заявка ещё не подтверждена.
- Логин не принимается: укажите его телефоном в формате +7XXXXXXXXXX.
ПЭК
Расчёт стоимости и сроков, отделения и зоны, статусы грузов и заявки на перевозку. Сценарии на странице интеграции.
Что умеет агент
Считать стоимость и сроки, проверять статусы грузов и оформлять заявки на перевозку.
Шаги
Войдите в кабинет
На kabinet.pecom.ru войдите учётной записью клиента: её логин и есть «Имя пользователя».
Выпустите ключ API
В «Регистрационных данных», блок «Ключи API», выпустите отдельный ключ для агента и вставьте его в «API-ключ».
Ограничения
Грузы контрагентов и документы видны только с расширенным личным кабинетом.
Как отозвать доступ
Нажмите «Отключить» в карточке и удалите этот ключ в блоке «Ключи API».
Неполадки
- Не видны грузы контрагентов: нужен расширенный личный кабинет ПЭК.
Яндекс Доставка
Расчёт цены, заявки на курьера, доставка по России, пункты выдачи и трекинг. Сценарии на странице интеграции.
Что умеет агент
Считать цену доставки, создавать заявки на курьера и отслеживать их.
Что нужно заранее
Логин и пароль кабинета dostavka.yandex.ru, которые выдал менеджер Яндекс Доставки.
Шаги
Получите токен
В кабинете на вкладке «Интеграция», раздел «Активируйте интеграцию», нажмите «Получить токен».
Вставьте токен
Вставьте его в поле «Токен доступа».
Ограничения
После смены пароля кабинета токен перестаёт работать.
Как отозвать доступ
Нажмите «Отключить» в карточке. Смена пароля кабинета закрывает доступ и на стороне Яндекс Доставки.
Неполадки
- «Ключи не приняты»: пароль кабинета сменили. Получите новый токен и нажмите «Ввести ключи заново».
ТК «Луч»
Грузоперевозки по Уралу: расчёт стоимости, заявки на перевозку и статусы грузов. Сценарии на странице интеграции.
Что умеет агент
Считать стоимость, оформлять заявки на перевозку и проверять статусы грузов.
Шаги
Попросите токены
Напишите в ОТР ИТ на info@otr-it.ru в свободной форме. Обычно они заводят рабочий чат с вашими сотрудниками.
Вставьте пару токенов
X-User вставьте в «Идентификатор (X-User)», X-Token в «Токен (X-Token)».
Ограничения
Заявки оформляются на организацию, к которой привязана учётная запись. Плательщика и способ оплаты по договору уточните у менеджера ТК «Луч».
Как отозвать доступ
Нажмите «Отключить» в карточке, а чтобы закрыть токены, напишите в ОТР ИТ.
Неполадки
- Заявка не оформляется: уточните у менеджера договор и плательщика.
ATI.SU
Биржа грузоперевозок: грузы, торги, машины, фирмы, АТИ-Доки, тайм-слоты и индекс ставок. Сценарии на странице интеграции.
Что умеет агент
Искать грузы и машины, работать с торгами, фирмами и документами АТИ-Доки.
Что нужно заранее
Подтверждённый аккаунт на ATI.SU. Для постоянной работы client_id, который выдают по письму на api@ati.su.
Шаги
Откройте «Мои токены»
Войдите под контактом фирмы и откройте ati.su/developers/tokens.
Запросите client_id
Напишите на api@ati.su имя и почту сотрудника, название продукта и цель использования API.
Создайте постоянный токен
Впишите client_id, нажмите «Создать токен» и скопируйте значение из столбца «Токен» в «API-токен».
Ограничения
- «Создать временный токен» выдаёт токен на короткий срок: хватит на проверку, но не на постоянную работу.
- Токен перестаёт работать при смене пароля, удалении контакта или фирмы.
Как отозвать доступ
Нажмите «Отключить» в карточке и удалите токен в «Моих токенах».
Неполадки
- Подключение перестало работать: истёк временный токен или сменили пароль контакта.
Yandex Fleet
Автопарк Яндекс Такси: автомобили, водители и курьеры, заказы, GPS-треки и транзакции. Сценарии на странице интеграции.
Что умеет агент
Читать автомобили, водителей, заказы, треки и транзакции парка.
Что нужно заранее
Роль «Директор» в кабинете fleet.yandex.ru: под другой ролью ключ не создать.
Шаги
Откройте раздел «API»
В Диспетчерской выберите «Настройки» и перейдите в раздел «API».
Создайте ключ и перенесите три значения
Секретный ключ вставьте в «API-ключ», идентификатор клиента в «ID клиента (Clid, например taxi/park/<uuid>)», идентификатор партнёра в «ID парка (UUID)». Ключ показывается один раз.
Как отозвать доступ
Нажмите «Отключить» в карточке и удалите ключ в разделе «API» Диспетчерской.
Неполадки
- Не получается создать ключ: у вас не роль «Директор».
StarLine
Автосигнализация: координаты, состояние машины, дистанционные команды и OBD. Сценарии на странице интеграции.
Что умеет агент
Читать координаты и состояние машин аккаунта и отправлять дистанционные команды.
Что нужно заранее
Аккаунт StarLine ID, в списке устройств которого виден комплекс, и одобренная заявка разработчика.
Шаги
Отправьте заявку
На my.starline.ru в разделе «Разработчикам» (виден при русском языке интерфейса) опишите цели использования API. Одобрение придёт письмом.
Создайте приложение
После письма откройте «Разработчикам» → «Создать приложение». AppId вставьте в «ID приложения», Secret в «Секрет приложения».
Укажите вход StarLine ID
Заполните «Логин StarLine ID» и «Пароль StarLine ID».
Ограничения
Ключи открывают только машины этого аккаунта StarLine ID.
Как отозвать доступ
Нажмите «Отключить» в карточке и удалите приложение в разделе «Разработчикам».
Неполадки
- Заявку не рассматривают: в ней не описаны цели использования API.
Частые вопросы
В кабинете СДЭК нет раздела с ключами. Почему?
Ключи API СДЭК выдаёт только по договору на юрлицо или ИП. Без договора кабинет работает как розничный, и раздела «Интеграция» в нём нет.
Временный токен ATI.SU перестал работать. Что делать?
Временный токен годится для проверки. Для постоянной работы запросите client_id на api@ati.su и создайте постоянный токен на ati.su/developers/tokens.
Почему Почта России не даёт токен сразу после регистрации?
Регистрация на otpravka.pochta.ru отправляет заявку на доступ и договор на подпись. Пока заявка не подтверждена, токена в кабинете нет.
Что нужно для Yandex Fleet?
Роль «Директор» в кабинете автопарка и три значения из раздела «API» Диспетчерской: секретный ключ, идентификатор клиента и идентификатор парка.
Смотрите также
Не нашли ответ? Как связаться