Возможности · Интеграция по API

Открытый REST API для своей интеграции

REST API «Инструментов логиста 24» покрывает весь цикл — от приёма заказа из вашей ERP или маркетплейса до возврата факта доставки. OpenAPI-спецификация, webhook’и на статусы заказов и DataViews для серверной синхронизации — всё, что нужно интегратору TMS.

Архитектура интеграции через APIИнструментылогиста 24REST APIERP / 1Сучётная системаМаркетплейсWB, OZON, Я.МаркетWMSуправление складомBI / DataLensотчётыСвой кабинетклиентаЧат-ботклиенту/водителюSMS / мессенджерсвой шлюзГЛОНАСС / GPSсвоя телематика
POST https://app.logistic.tools/lt24/api/orders
● 200 OK
# curl: создать заказ
curl -X POST https://app.logistic.tools/lt24/api/orders \
  -H "SessionId: a3f1b8e2-5c4d-4f80-9a72-1c2e9d3b04c1" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "WB-0421",
    "departure": 
      "location": 
        "lat": 59.960016,
        "lon": 30.311053,
        "raw": "Санкт-Петербург, ул. Ленина, 3"
  }'
# ответ: 200 OK
{
  "id": "0ef1c2a4-1b9f-4d3e-8a72-93b6f0c14a51",
  "external_id": "WB-0421",
  "active": true,
  "version": 1714388062,
  "created": 1714388062,
  "last_modified": 1714388062,
  "custom_fields": []
}
Любые дополнительные данные — через custom_fields (UUID + value), файлы и фото — отдельные эндпоинты. Полная схема — в документации.
REST + JSON OpenAPI / Swagger Webhook'и на события DataViews — серверная синхронизация Полная документация →
Возможности

Что покрывает API

REST API покрывает все основные сущности и процессы сервиса — от приёма заказов до возврата фактов выполнения.

Заказы и доставка

Создание, обновление, статусы, файлы, фото, оценки качества — всё, что есть в кабинете, доступно через API.

Планирование рейсов

Запуск алгоритма оптимизации, загрузка готовых рейсов, переоптимизация на лету, маршрутизация между точками.

Справочники

Водители, машины, прицепы, склады, клиенты, товары, тарифы, зоны и теги — всё, на чём строится планирование.

Уведомления

Шаблоны SMS, email, push и чата клиенту и водителю — управляйте коммуникацией программно.

Аналитика и архивы

Архивы заказов и рейсов, статистика аккаунта, расписание отчётов — поток данных в вашу BI.

Синхронизация (DataViews)

Серверный кэш с отслеживанием изменений: тяните только дельты, экономьте трафик и держите свою копию данных в актуальном состоянии.

Сценарии

Типовые сценарии интеграции

Через API клиенты собирают свои бизнес-процессы — от приёма заказа из своей системы до сборки собственного клиентского кабинета.

Передавайте заказы из своей ERP/CRM

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

Получайте факты выполнения обратно

Статус, время доставки, фото и комментарий водителя возвращаются в вашу учётную систему.

Подключите свой ГЛОНАСС/GPS

Заводите координаты со своей телематики через API и видите свои машины на карте сервиса.

Подключите свой SMS-шлюз или мессенджер

Используйте корпоративный канал уведомлений вместо встроенных провайдеров.

Соберите свой кабинет клиента

Карта маршрута и живой ETA на вашем сайте — через DataViews и webhook'и.

Сводите данные в свою BI

Архивы рейсов и заказов в Power BI, Metabase, Yandex DataLens — через расписание выгрузок.

Поток данных

Как устроена интеграция

Подключите справочники и заказы — получите рейсы. Возврат фактов работает по push (webhook) или pull (DataViews) на ваш выбор.

/01

Авторизация

Получите SessionId через POST /auth/token (login + password) и используйте его в заголовке всех последующих запросов.

/02

Передача данных

Справочники и заказы летят в сервис через REST. Создание, обновление, привязка файлов и фото к заказу.

/03

Планирование и выполнение

Алгоритм строит рейсы, водители их выполняют, статусы и фото фиксируются.

/04

Возврат фактов

Обновления приходят к вам через webhook'и или DataViews — без опросов «в лоб».

Преимущества

Преимущества веб-сервиса «Инструменты логиста 24»

С нами работать просто и удобно: облачный сервис без установки, оплата по факту использования и поддержка на всех этапах внедрения.

Доступ из любой точки мира

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

Платите только за то, что используете

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

Не надо ничего устанавливать

Просто регистрируйтесь и уже можете работать — не надо ничего устанавливать и настраивать. Все обновления входят в стоимость подписки.

Консультируем клиентов и постоянно развиваемся

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

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

Частые вопросы об API и интеграции

Остались вопросы — запишитесь на демонстрацию, покажем интеграцию на реальных данных.

Какой формат у API — REST или GraphQL?

API построен по REST: HTTPS, JSON, стандартные методы GET/POST/PUT/DELETE. Спецификация публикуется в OpenAPI 3 (Swagger) — её можно открыть в Swagger UI на developers.logistic.tools, импортировать в Postman или сгенерировать клиент на любом языке.

Как авторизоваться в API и долго ли живёт сессия?

Авторизация — через POST /auth/token с логином и паролем технической учётной записи; в ответ приходит SessionId, который передаётся в заголовке всех последующих запросов. Сессия живёт несколько часов и обновляется по тому же эндпоинту — отдельный refresh-token не нужен.

Можно ли получать события через webhook вместо опроса?

Да. На события — новый статус заказа, изменение состава рейса, факт доставки, обновление координат водителя — можно подписаться webhook'ами: мы вызываем ваш HTTPS-эндпоинт с JSON-телом события. Для массовой синхронизации справочников и архивов есть альтернатива — DataViews: серверный кэш с отслеживанием изменений, из которого вы тянете только дельты.

Какие системы можно интегрировать через API?

Любые: учётные системы (1С, Битрикс24, SAP, кастомные ERP), маркетплейсы (Wildberries, Ozon, Я.Маркет), CRM, WMS, BI-платформы (Power BI, Metabase, Yandex DataLens), собственные сайты и кабинеты клиента, телематика (ГЛОНАСС/GPS), SMS-шлюзы и мессенджеры. Для 1С есть готовое расширение и внешняя обработка — подробнее на странице «Интеграция с 1С».

Есть ли тестовый контур (sandbox) и примеры запросов?

Тестовый контур — это любая ваша рабочая база с триал-аккаунтом: 14 дней полнофункционального доступа без ограничений по эндпоинтам, можно создавать и удалять данные. Примеры curl и схемы запросов/ответов есть в OpenAPI-спецификации; для нестандартных сценариев интеграторы получают консультации команды.

Сколько времени занимает интеграция?

Базовая интеграция — передача заказов из ERP и получение фактов через webhook — займёт 2–5 рабочих дней силами одного backend-разработчика. Для типовых сценариев (1С, маркетплейсы, BI) есть готовые рецепты. Сложные интеграции со своим кабинетом клиента обычно занимают 2–3 недели; команда сопровождает интегратора в чате и созвонами.

Блог

Статьи по теме

Все статьи →
14 дней бесплатно

Нужна дополнительная консультация?

Подключите API за пару дней. Помощь интеграторов и 14 дней без ограничений — на полном функционале.