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

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

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

Что даёт интеграция по API

Документооборот перевозки переезжает туда, где у компании уже лежат сведения о грузах, рейсах и контрагентах, — отдельный кабинет сотрудникам не нужен.

Обмен в своей программе

Документы уходят контрагентам и приходят от них прямо в той учётной системе, к которой сотрудники привыкли. Осваивать новый интерфейс и держать открытым ещё одно окно не приходится.

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

Титул подписывают квалифицированной электронной подписью и отправляют там же, где его открыли. Водитель подтверждает свою часть простой электронной подписью — согласование с ним тоже идёт через API.

Документы из учётных данных

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

Массовая обработка

ЭПД обрабатываются пачками, а не по одному. Изменения и статусы система получает сама — из ленты событий и реестра документов, без ручной сверки с контрагентами.

Что умеет API Логистики

Функции API покрывают весь путь электронной транспортной накладной — от первого титула до архива завершённой перевозки.

Титулы и подписи

  • Титулы ЭТрН — создание и обработка всех титулов накладной
  • Подпись — КЭП для титулов, ПЭП для согласования с водителем
  • Черновики — Т1 и Т3 можно отправить без подписи, наравне с полностью подписанными титулами
  • Исправления — правка подписанных титулов, цепочка версий сохраняется
  • Печатная форма — ЭТрН в формате PDF

Перевозка и контроль

  • ГИС ЭПД — обмен с государственной информационной системой электронных перевозочных документов
  • QR-код — код перевозки, который могут запросить инспекторы ГИБДД
  • Лента событий — хронология изменений накладной
  • Реестр — перечень документов ЭТрН
  • Архив — весь документооборот по перевозке целиком

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

Доступ открывается через менеджера Контур.Логистики: от запроса до первых вызовов методов — четыре шага.

1

Запрос

Сообщите своему менеджеру, что планируете интеграцию по API. Менеджера ещё нет — оставьте заявку в форме внизу страницы.

2

Приглашение

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

3

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

В Кабинет интегратора входят с той же учётной записью, что и в Логистику, и открывают в нём своё приложение.

4

Аутентификация

Для приложения выбирают и настраивают способ аутентификации — API-Key или OpenID Connect. После этого запросы к методам проходят авторизацию.

Что важно знать разработчику

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

Площадки

Отлаживать интеграцию можно на тестовой площадке, а в работу она выходит на одной из двух рабочих — со стандартным или с ГОСТ-шифрованием.

  • Тестовая — logist-api-staging.kontur.ru
  • Рабочая, стандартное шифрование — logist-api.kontur.ru
  • Рабочая, ГОСТ-шифрование — logist-api-gost.kontur.ru

Авторизация

Запросы авторизуются API-ключом или по протоколу OpenID Connect. Если в запросе нет ни ключа, ни токена доступа, сервис отвечает ошибкой 401 Unauthorized.

Разделы методов

Методы сгруппированы по шести разделам: документы, организации, перевозки, реестр, события и шлюз Минтранса.

Титулы накладной

В ЭТрН четыре обязательных титула, Т1–Т4, и четыре опциональных, Т5–Т8. Обычный порядок отправки — Т1 → Т2 → Т3 → Т4, затем при необходимости Т5 и Т6.

Доставка через Диадок

Титулы идут от одного участника перевозки к другому через Контур.Диадок. Там документ имеет тип LogisticsWaybill и версию формата kl_trn_mt_05_01 — формат Минтранса 5.01.

Кто подписывает каждый титул и когда накладная обязательна — на странице ЭТрН.

Другие способы работы в Логистике

Если писать интеграцию не планируется, подойдёт готовое решение — для своей учётной системы, для 1С, для SAP или вовсе без интеграции.

← Все интеграции

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

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

Подключите интеграцию по API

Расскажите в заявке, в какой системе ведёте учёт перевозок и сколько документов оформляете в месяц, — менеджер Контур.Логистики откроет доступ к API, пришлёт приглашение в Кабинет интегратора и поможет выбрать пакет документов.

Стоимость зависит от пакета документов — пакеты и условия собраны на странице тарифов.