Интеграция по API

Программный интерфейс Контур.Логистики встраивается в любую учётную систему — собственную или самописную. Формируйте, подписывайте и отправляйте электронные перевозочные документы, не покидая привычной программы.


Подключиться Попробовать бесплатно

Что можно делать через API

Весь путь электронной транспортной накладной — от создания до архива — доступен из вашей системы. Документы можно формировать из данных учётной системы и обрабатывать пачками.


Все титулы ЭТрН

Создавайте и обрабатывайте каждый титул накладной прямо из своей программы. Для Т1 и Т3 можно отправить черновик без подписи.

Подпись и согласование

Подписывайте титулы КЭП, а согласование с водителем проводите с помощью простой электронной подписи (ПЭП).

Работа с ГИС ЭПД

Обменивайтесь данными с государственной информационной системой электронных перевозочных документов — для этого в API есть отдельный шлюз Минтранса.

Печатная форма и QR-код

Получайте печатную форму ЭТрН в PDF и QR-код перевозки, который могут запросить инспекторы ГИБДД.

Архив и реестр

Забирайте полный архив документооборота по перевозке и реестр документов ЭТрН.

События и исправления

Следите за хронологией изменений накладной по ленте событий и вносите правки в подписанные титулы — цепочка версий сохраняется.

Из каких титулов состоит ЭТрН

Накладная собирается из четырёх обязательных и четырёх необязательных титулов. Базовый сценарий отправки выглядит так: Т1 → Т2 → Т3 → Т4 → Т5* → Т6* (звёздочкой отмечены необязательные).


Обязательные титулы

  • Т1 — сведения грузоотправителя
  • Т2 — перевозчик подтверждает приём груза
  • Т3 — грузополучатель подтверждает выдачу груза
  • Т4 — перевозчик фиксирует выдачу груза

Необязательные титулы

  • Т5 — перевозчик указывает стоимость
  • Т6 — грузоотправитель указывает стоимость
  • Т7 — оформление переадресовки
  • Т8 — замена водителя или транспортного средства

Логистика передаёт титулы от одного участника перевозки к другому через Диадок. Если вы уже интегрировали Диадок, обычный обмен документами с контрагентами вам знаком: API Диадока позволяет делать из учётной системы то же, что и в веб-интерфейсе.

Как получить доступ к API

Подключение начинается с обращения к менеджеру и заканчивается настройкой способа входа для вашего приложения.


1

Запросите доступ

Напишите своему менеджеру. Если менеджера у вас пока нет, оставьте заявку внизу этой страницы.

2

Получите приглашение

Менеджер пришлёт приглашение в Кабинет интегратора и идентификатор приложения — client_id.

3

Войдите в кабинет

В Кабинет интегратора заходите с учётной записью Логистики.

4

Настройте вход

Выберите своё приложение и укажите способ аутентификации — API-Key или OpenID Connect.

Площадки и авторизация

У API три адреса: одна площадка для пробных запросов и две рабочие — на выбор, в зависимости от того, какое шифрование вам нужно.


Тестовая площадка

Для пробных запросов и отладки интеграции.

logist-api-staging.kontur.ru

Рабочая площадка

Боевой контур со стандартным шифрованием.

logist-api.kontur.ru

Рабочая площадка с ГОСТ

Боевой контур с ГОСТ-шифрованием.

logist-api-gost.kontur.ru


Запросы авторизуются одним из двух способов — API-Key или OpenID Connect. Без ключа и токена сервис вернёт ошибку 401 Unauthorized. Методы собраны в шесть разделов: документы, организации, перевозки, реестр, события и шлюз Минтранса.

Частые вопросы


Как получить доступ к API?
Запросите доступ у своего менеджера — если менеджера пока нет, отправьте заявку на этой странице. Менеджер пришлёт приглашение в Кабинет интегратора и идентификатор приложения client_id.
Как авторизоваться в API?
Доступны два способа: API-Key и OpenID Connect. Если в запросе нет ни API-ключа, ни токена доступа, сервис ответит ошибкой 401 Unauthorized.
Где сначала проверить интеграцию?
Для пробных запросов есть отдельная тестовая площадка. Когда всё работает, переключитесь на рабочую — со стандартным или с ГОСТ-шифрованием.
С какими документами работает API?
Интерфейс подходит для работы со всеми электронными перевозочными документами. Для ЭТрН доступны все титулы, подпись, печатная форма, QR-код перевозки, архив документооборота и лента событий.
Как Логистика связана с Диадоком?
Титулы уходят от одного участника перевозки к другому через Диадок. В нём накладная имеет тип документа LogisticsWaybill и формат kl_trn_mt_05_01 — это формат Минтранса версии 5.01.

Заявка на интеграцию

Расскажите, в какой учётной системе вы работаете и какие документы хотите передавать, — менеджер подскажет, как получить доступ к API.

Попробовать сервис можно бесплатно — условия на странице бесплатного периода.