ATI.SU и 1С: заявки, ставки, статусы и ошибки обмена

Как автоматизировать обмен данными с крупнейшей биржей грузоперевозок и не сломать бухгалтерию

Зачем логисту вообще заниматься интеграцией

Компания, которая возит или заказывает грузы, обычно ведёт учёт в одной системе — 1С, TMS или собственной ERP — а работу с перевозчиками и грузовладельцами ведёт на бирже ATI.SU. Пока объём небольшой, двойной ввод данных терпим: логист вручную копирует груз из 1С на биржу, а после — статус сделки и документы обратно в учётную систему.

Проблема начинается, когда грузов становится много. Ручное копирование съедает время логистов, провоцирует опечатки в адресах и суммах, а руководству сложно проконтролировать, что происходит на бирже, если вся работа идёт «в соседнем окне». Интеграция снимает именно эту рутину: данные о грузе вносятся один раз, в привычной корпоративной системе, а дальше распространяются автоматически.

Статья пригодится логистам, ИТ-специалистам и руководителям компаний-грузовладельцев, экспедиторов и перевозчиков, которые рассматривают подключение API ATI.SU к 1С, TMS или собственной учётной системе, и хотят понять реальный объём работ до начала проекта.

Что такое API ATI.SU простыми словами

ATI.SU — крупнейшая в России и СНГ биржа грузоперевозок и экосистема логистических сервисов: поиск грузов и транспорта, электронный документооборот «АТИ-Доки», проверка контрагентов, аналитика ставок [12][21]. API — это набор программных интерфейсов, через которые сторонняя система (1С, TMS, самописный сервис) может выполнять те же действия, что пользователь делает вручную на сайте: добавлять груз, искать перевозчика, получать список фирм, отправлять и подписывать документы [5][6].

Официальная позиция биржи в том, что интеграция позволяет логистам работать в «одном окне» — без переключения между корпоративной системой и сайтом ATI.SU, снижая количество ошибок ручного ввода и ускоряя обработку заявок [5].

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

Авторизация: clientid, accesstoken, OAuth 2.0

Доступ к API строится на двух сущностях. client_id — идентификатор конкретного программного продукта: например, для интеграции с 1С биржа выдаёт отдельный client_id именно для этого решения [3]. access_token — ключ доступа к методам API от имени конкретного контакта (сотрудника компании) в рамках этого продукта [1][3]. Получить client_id можно, оформив заявку в тикет-систему консультантам по интеграции с указанием ФИО и email ответственного сотрудника и названия программного продукта [1].

Сама авторизация построена на протоколе OAuth 2.0: интегратор получает временный код (code), который обменивается на access_token через отдельный метод с параметрами client_id, client_secret, code и grant_type [2]. Токен ограничен по времени жизни, а на один client_id у одного контакта может быть только один действующий access_token — если он утерян или скомпрометирован, доступ отзывается через личный кабинет разработчика [3][4].

Какие данные и процессы можно автоматизировать

Каталог API ATI.SU включает несколько групп методов [5][6]:

• Грузы — добавление, редактирование грузов, получение встречных предложений, работа с грузами на закрытых Площадках [6][7].
• Машины — добавление, изменение и удаление информации о транспортных средствах.
• Заказы — приглашение перевозчика, оформление заказа и автоматизация последующих этапов сделки.
• Торги — автоматизация проведения торгов по заказу на перевозку.
• Фирмы — получение контактов, реквизитов и краткой информации об участниках биржи.
• Площадки — закрытые списки грузов для доверенных перевозчиков и экспедиторов, в том числе персональные площадки самой компании [8].
• АТИ-Доки — получение списка документов, создание, подписание квалифицированной электронной подписью (КЭП), согласование и комментирование неформализованных документов [10].
• Мессенджер и аналитика (средние ставки, индекс направлений) — часть аналитических API доступна бесплатно [5].

Важная деталь для интеграции с бухгалтерией: на момент подготовки статьи создание, редактирование и подписание универсального передаточного документа (УПД) через API АТИ-Доков ещё не реализовано — работать с УПД пока приходится через интерфейс сайта [10].

Тестирование без песочницы

У API ATI.SU нет отдельной тестовой среды — весь функционал отрабатывается на основном (боевом) сайте [3]. Рекомендованный биржей способ протестировать добавление и работу с грузами, не показывая их посторонним пользователям — создать персональную Площадку, где участниками будут только сотрудники компании [3][8]. Это стоит закладывать в план проекта отдельным этапом: тестирование ведётся не в изолированном стенде, а в контролируемом, но реальном окружении.

Российская специфика

Лицензирование и оплата доступа

Часть API — аналитика по ставкам и индексам направлений — доступна бесплатно [5]. Доступ к «рабочим» методам (грузы, заказы, торги, документооборот) оформляется как обычная лицензия ATI.SU — оплачивается на срок от одного месяца [5][11]. Для отладки интеграции биржа предлагает написать в поддержку и запросить бесплатную демоверсию доступа [5]. Оплата возможна в рублях и ряде валют СНГ, а для разовых небольших операций используется внутренний виртуальный счёт [11].

Электронный документооборот и обязательная ЭТрН с 2026 года

«АТИ-Доки» — система электронного документооборота биржи, действующая с 2013 года; в 2022 году сервис подтвердил соответствие требованиям к операторам ЭДО счетов-фактур, актуальным с марта 2022 года [15]. Отдельно ATI.SU обеспечивает обмен электронными транспортными накладными (ЭТрН) на базе решения ГК «Астрал» — участники перевозки создают, подписывают и хранят ЭТрН прямо на платформе, без перехода во внешние системы [16].

Это особенно важно в свете изменений законодательства: с 1 сентября 2026 года электронная транспортная накладная и электронный заказ-заявка становятся обязательными для большинства автомобильных, а также ряда железнодорожных и авиаперевозок [19][20][21]. Обмен ЭТрН потребует заключения договора с оператором информационной системы электронных перевозочных документов (ИС ЭПД) из реестра Минтранса и наличия усиленной квалифицированной электронной подписи у ответственных сотрудников [19]. Для компаний, уже работающих с грузами через ATI.SU, это означает, что интеграцию документооборота стоит планировать не как факультативное удобство, а как часть подготовки к обязательному переходу.

Обратите внимание: для отдельных перевозок Минтранс готовит перечень исключений, когда бумажные документы останутся допустимыми — это стоит уточнять по мере приближения даты вступления требований в силу и появления подзаконных актов [21].

Варианты реализации интеграции

1. Готовое расширение для 1С

В 2022 году ATI.SU представила демонстрационное расширение для интеграции своего API с продуктами «1С», позволяющее добавлять грузы на сайт прямо из учётной системы на платформе «1С:Предприятие» [14]. Сама биржа прямо указывает: разнообразие конфигураций 1С делает создание единого универсального решения сложной задачей, поэтому демо-расширение — это, скорее, подтверждение работоспособности связки, чем готовый к промышленной эксплуатации продукт [14]. На практике это значит, что под конкретную конфигурацию (Управление торговлей, ERP, отраслевое решение) почти всегда нужна доработка.

2. Доработка через API под свою конфигурацию

Второй вариант — разработка собственного модуля обмена поверх REST API ATI.SU: получение client_id, реализация OAuth 2.0-авторизации, а затем — вызов нужных методов (грузы, заказы, доки) из кода конфигурации 1С, TMS или другой учётной системы. Это более трудоёмкий, но гибкий путь: можно точно описать, какие поля 1С соответствуют полям API, как обрабатывать конфликты при добавлении похожих грузов [6] и как синхронизировать статусы заказов и документов.

3. Готовый коннектор в TMS

Ряд TMS-систем на российском рынке уже поставляется со встроенной интеграцией к биржам грузоперевозок, включая ATI.SU — это позволяет ускорить обработку заказов без отдельной разработки [17]. Одновременно стоит понимать ограничение: биржи и маркетплейсы грузоперевозок остаются, по сути, «рынком» — быстрым доступом к перевозчикам — а не системой управления закупкой логистики; они не хранят внутренние квоты, стратегию распределения объёмов и накопленную историю по каждому подрядчику [18]. Поэтому для компаний с большим количеством постоянных маршрутов и подрядчиков интеграция ATI.SU часто дополняет TMS, а не заменяет её функции управления закупкой.

Практические этапы внедрения

Независимо от выбранного варианта, работа обычно проходит через одни и те же шаги.

1. Определить участвующие системы и данные. Что именно синхронизируется: карточки грузов, статусы заказов, документы, контрагенты — и в какую сторону идёт поток данных (из 1С на биржу, с биржи в 1С, или в обе стороны).
2. Оформить заявку на client_id. Через тикет-систему консультантам по интеграции API, указав ответственного сотрудника, email и название программного продукта [1].
3. Спроектировать авторизацию. Определить, кто из сотрудников будет получать access_token, как токены будут храниться и обновляться, что делать при истечении времени жизни кода авторизации [2][3].
4. Реализовать обмен данными. Написать или адаптировать код, который вызывает нужные методы API (грузы, заказы, доки) и обрабатывает ошибки — например, конфликты при похожих грузах [6].
5. Протестировать на персональной Площадке. Поскольку отдельной песочницы нет, тестовые грузы стоит размещать там, где их видят только сотрудники компании [3][8].
6. Оформить лицензию и перейти в промышленную эксплуатацию. Оплатить доступ к нужным платным методам API, если тестовый период демоверсии закончился [5][11].
7. Подготовиться к обязательной ЭТрН. Если компания ещё не перешла на электронный документооборот перевозочных документов, отдельно спланировать подключение к оператору ИС ЭПД и получение УКЭП с учётом срока 1 сентября 2026 года [19][21].

Ограничения, ошибки и риски

• Нет тестовой песочницы — ошибки в логике интеграции могут проявиться на реальных данных, если не использовать персональные Площадки для отладки [3].
• Не всё бесплатно — аналитические API открыты без оплаты, но основные операционные методы обычно требуют действующей лицензии [5][11].
• УПД нельзя создать и подписать через API АТИ-Доков — если бухгалтерии нужен именно этот документ, его придётся оформлять вручную на сайте, пока функциональность не расширена [10].
• Демо-расширение для 1С — не универсальное решение — под конкретную конфигурацию почти всегда нужна доработка, и закладывать бюджет только на «готовый модуль» рискованно [14].
• Конфликты при добавлении похожих грузов — система может расценить новый груз как дубликат уже существующего; логику обработки таких ситуаций нужно предусмотреть заранее [6].
• Биржа — не замена TMS для управления закупкой — если у компании сотни маршрутов и десятки подрядчиков, одной интеграции с ATI.SU может быть недостаточно для управления стратегией закупки логистики [18].
• Один активный токен на контакт — при смене сотрудника или компрометации токена доступ нужно вовремя отзывать и перевыпускать [4].

Как выбрать подходящий вариант

Если объём грузов небольшой, а типовая конфигурация 1С близка к той, под которую делалось демо-расширение, разумно начать с готового решения и оценить, покрывает ли оно реальные процессы компании. Если конфигурация нетиповая, объём высокий или нужна тонкая логика (например, автоматическое распределение грузов между несколькими Площадками, интеграция статусов заказов с бухгалтерией) — потребуется доработка через API. Если в компании уже используется TMS с готовым коннектором к ATI.SU, часто выгоднее оценить его возможности, прежде чем начинать разработку с нуля [17].

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

Как может помочь «Пятый фактор»

Основная сложность подобной интеграции обычно не в самом факте подключения к API, а в сопоставлении полей 1С или TMS с методами ATI.SU, в обработке конфликтов и ошибок и в контроле обмена данными между системами — особенно если нужно параллельно готовиться к обязательному переходу на ЭТрН. Команда «Пятого фактора» может изучить задачу, оценить возможные варианты реализации и помочь с разработкой, интеграцией или технической консультацией — в зависимости от того, достаточно ли компании готового расширения или нужна доработка под конкретную конфигурацию 1С или TMS.

API ATI.SU даёт достаточно широкий набор методов, чтобы перенести основную часть работы с биржей в привычную учётную систему — от размещения грузов до документооборота. Но готовое решение для 1С — это, по признанию самой биржи, демонстрационная, а не универсальная разработка, тестовой песочницы у API нет, а часть функциональности (например, работа с УПД) пока не реализована. Прежде чем выбирать между готовым модулем, доработкой через API и коннектором в TMS, стоит трезво оценить объём грузов, особенности конфигурации учётной системы и то, насколько скоро компании нужно быть готовой к обязательной электронной транспортной накладной с сентября 2026 года.

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

Источники

[1] ati.su — Авторизация | API ATI.SU — https://ati.su/developers/auth/auth/

[2] ati.su — Авторизация по OAuth 2.0 | API ATI.SU — https://ati.su/developers/auth/auth-v2/

[3] ati.su — Частые вопросы | API ATI.SU — https://ati.su/developers/support/faq/

[4] ati.su — Мои токены | API ATI.SU — https://ati.su/developers/tokens/

[5] ati.su — API ATI.SU — https://ati.su/landings/api-ati/

[6] ati.su — API для работы с Грузами | API ATI.SU — https://ati.su/developers/api/loads/

[7] ati.su — Опубликованные грузы | API ATI.SU — https://ati.su/developers/api/loads/published/

[8] ati.su — Площадки ATI.SU | API ATI.SU — https://ati.su/developers/api/boards/

[9] ati.su — Как найти груз | API ATI.SU — https://ati.su/developers/usecases/carrier/finddeal/

[10] ati.su — API для работы с АТИ-Доками | API ATI.SU — https://ati.su/developers/api/doki/

[11] help.ati.su — Оплата и подключение к ATI.SU — https://help.ati.su/kak-i-za-chto-platit-v-avtotransinfo

[12] about.ati.su — Об IT-компании ATI.SU — https://about.ati.su/

[13] tadviser.ru — ATI.SU: Портал документации API — https://www.tadviser.ru/index.php/Продукт:ATI.SU:_Портал_документации_API

[14] cnews.ru — ATI.SU представила расширение своего API для интеграции с продуктами «1С» — https://www.cnews.ru/news/line/2023-06-05_atisu_predstavila_rasshirenie

[15] tadviser.ru — ATI.SU: АТИ-Доки — https://www.tadviser.ru/index.php/Продукт:ATI.SU:_АТИ-Доки

[16] astral.ru — ATI.SU и ГК «Астрал»: работа с ЭТрН — https://astral.ru/aj/elem/ati-su-i-gk-astral-obespechivayut-bespereboynuyu-rabotu-sistemy-elektronnykh-transportnykh-nakladnykh/

[17] roolz.net — ТОП-11 TMS-систем для управления транспортом на 2026 год — https://roolz.net/ru/info/best-tms-software/

[18] vc.ru — TMS и биржи не спасут: зачем грузовладельцам отдельные платформы управления закупкой логистики — https://vc.ru/services/2748635-platformy-upravleniya-zakupkoy-logistiki

[19] consultant.ru — Электронная транспортная накладная (подборка документов) — https://www.consultant.ru/law/podborki/jelektronnaya_transportnaya_nakladnaya/

[20] kontur-extern.ru — Транспортная накладная с 1 сентября 2024: как сформировать и отправить — https://www.kontur-extern.ru/info/25684-transportnaya_nakladnaya_s_1_sentyabrya_2022_goda

[21] sberbusiness.live — Электронная транспортная накладная — 2026: правила и форма — https://sberbusiness.live/publications/transportnaya-nakladnaya-obrazec-kak-zapolnit-pravilno