Переход маршрутизации курьеров 2ГИС на TSP API 2.0
Переход на 2ГИС TSP API 2.0 стал актуальным после выпуска новой версии 9 июня 2026 года и прекращения поддержки версии 1.1.0. Интеграция со старой моделью рискует остановить автоматическое планирование: диспетчер получает заказы, а рабочая система остаётся без готовой последовательности точек и назначений курьеров.
В версии 2.0 структура задачи стала подробнее. Параметры points, routes, couriers и depot описывают участников расчёта отдельными сущностями. Поэтому обновление затрагивает одновременно подготовку исходных данных, запрос к API, сопоставление результата с внутренними идентификаторами и экран, где диспетчер принимает план.
Мы разбираем текущий поток из CRM, OMS, WMS или таблицы: адрес, координаты, заказ, курьер, депо и связанные ограничения. Затем составляем карту полей 1.1.0 и 2.0, обновляем сериализацию и сохраняем устойчивые ключи. Ответ TSP связывается с исходными заказами и курьерами, чтобы новая последовательность появилась в привычном маршрутном листе.
Контрольный расчёт выполняется на реальном типе смены с подготовленными тестовыми данными. Сверяем количество точек, назначения, начало маршрута, возвращённую последовательность и позиции, которые требуют внимания диспетчера. После запуска журнал показывает версию API, состав задачи, результат и причину каждой необработанной точки.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Планировщик продолжает обращаться к TSP API 1.1.0, поддержка которого прекращена после выпуска версии 2.0.
- Новая версия уже подключена, однако прежний плоский payload оставляет расширенные сущности points, couriers и depot пустыми.
- Расчёт возвращается, однако маршрут теряет связь с внутренними заказами либо назначает результат неизвестному курьеру.
- Диспетчер вручную исправляет большую часть выдачи, поскольку исключения и причины необработанных точек скрыты в техническом ответе.
Что именно мы сделаем
Находим вызовы TSP API 1.1.0, источники заказов, координат, курьеров, депо и место использования маршрута.
Сопоставляем внутреннюю модель доставки с расширенными points, routes, couriers и depot TSP API 2.0.
Обновляем формирование запроса, устойчивые идентификаторы, обработку ответа и статусы планирования.
Проводим контрольный расчёт, сверяем точки, назначения, последовательность и исключения для диспетчера.
Переключаем рабочий маршрут, добавляем журнал и передаём карту полей и инструкцию сопровождения.
Что входит в стоимость
59 900 ₽ за всю работу
Инвентаризируем вызовы TSP API 1.1.0 и внутреннюю модель доставки, сопоставляем прежние поля с расширенными параметрами points, routes, couriers и depot версии 2.0. Обновляем запрос, разбор результата, статусы и журнал. Сверяем контрольный день доставки, последовательность точек, назначения курьеров и сохранение результата в рабочей системе.
Что будет готово
Передадим вам
- Рабочий клиент 2ГИС TSP API 2.0 для действующего сценария курьерской маршрутизации.
- Карта полей CRM, OMS или WMS с актуальными структурами points, routes, couriers и depot.
- Обновлённый импорт маршрутов, назначений и исключений по устойчивым внутренним идентификаторам.
- Протокол контрольного расчёта, журнал запусков и инструкция сопровождения планировщика.
Перед сдачей проверим
- Контрольная задача отправляется в TSP API 2.0 с выбранными points, routes, couriers и depot и получает корректный ответ.
- Каждая возвращённая точка и назначение связываются с исходным заказом и курьером в рабочей системе.
- Количество точек, последовательность и исключения видны диспетчеру и подтверждены на контрольной смене.
- Повторный расчёт сохраняет отдельную версию плана, а журнал показывает параметры, длительность и итог запуска.
Как это выглядит на практике
Диспетчер получает готовые маршруты в рабочем кабинете
- 01
Заказы смены поступают из OMS с координатами и устойчивыми идентификаторами, а список курьеров — из рабочего справочника.
- 02
Интеграция собирает points, couriers, routes и depot и отправляет задачу в TSP API 2.0.
- 03
Полученная последовательность связывается с заказами и появляется в маршрутных листах назначенных курьеров.
- 04
Диспетчер видит итоговый план и отдельный список точек, которым требуется уточнение исходных данных.
Что понадобится для работы
От вас
- Код или настройки действующей интеграции 2ГИС TSP API 1.1.0 и журналы последних расчётов.
- Ключ API и доступ к выбранному тестовому или рабочему контуру маршрутизации.
- Описание источников точек, координат, курьеров, маршрутов, депо и внутренних идентификаторов.
- Контрольная смена и диспетчер, который подтвердит назначения, последовательность и обработку исключений.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 56 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Когда вышел 2ГИС TSP API 2.0?
Версия TSP API 2.0 выпущена 9 июня 2026 года. Вместе с релизом 2ГИС прекратил поддержку прежней версии 1.1.0.
Какие части запроса требуют обновления?
Проверяем расширенные параметры points, routes, couriers и depot, а также внутренние поля, из которых они собираются. Конкретная карта зависит от действующей модели доставки.
Сохранятся ли наши идентификаторы заказов?
Да. Перед отправкой связываем каждую точку и сущность с устойчивым ID из CRM, OMS или WMS, а после ответа используем эту связь для записи маршрута.
Что происходит с точкой с ошибочными координатами?
Предварительная проверка выделяет такую запись до расчёта или помещает ответ API в понятный список исключений. Диспетчер видит заказ и причину, которую требуется исправить.
Можно проверить версию 2.0 до рабочего переключения?
Да. Собираем контрольную смену, рассчитываем её через новый маршрут и сравниваем точки, курьеров, последовательность и исключения с ожидаемым рабочим результатом.
Куда записывается готовый маршрут?
Результат возвращается в действующую CRM, OMS, WMS, кабинет диспетчера или маршрутный лист. При проектировании сохраняем привычное место работы сотрудников.
Что увидит диспетчер при повторном расчёте?
Новая выдача получает отдельную версию и время запуска. Предыдущий план остаётся доступен для сравнения, а журнал показывает изменившийся состав исходной задачи.
Как принимается переход на TSP API 2.0?
Отправляем контрольный набор, получаем маршруты и сверяем каждую точку и назначение с внутренними ID. Диспетчер подтверждает последовательность и список исключений в рабочем интерфейсе.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Синхронизация филиалов с сайтом, Яндексом и 2ГИС
Синхронизировать адреса филиалов и точки 2ГИС
- 02Переход маршрутизации курьеров 2ГИС на TSP API 2.0
Перевести расчёт курьерских маршрутов на TSP API 2.0
- 03Выдавать клиенту персональный маршрут поездки
Показывать клиенту персональный маршрут поездки