Важные новости про API Средних ставок

1️⃣Завершается бесплатный пробный период.
Со следующей недели доступ к API Средних ставок будет стоить 9 900 ₽ в месяц. Оплатить доступ можно будет, как и любую другую лицензию, на странице биллинга.

2⃣Изменится структура ответа в контракте метода /priceline/license/v1/average_prices.
Если вы настраивали автоматизацию, то со следующей недели она перестанет работать. Чтобы продолжить работу, воспользуйтесь новой структурой ответа.
Новая структура позволит возвращать данные в более удобном виде. Например: раньше API всегда отдавал 6 полей — 3 с НДС и 3 без НДС. Теперь будет возвращаться только 3 поля, в зависимости от вашего запроса.

Мы добавили новый метод с выбором действия для отклонения Заказов в согласовании.
Теперь через API ATI.SU грузовладельцы могут отклонять Заказы, если перевозчики отредактировали данные в документе, оформленном через АТИ-Доки.
При отклонении Заказа можно выбрать, что сделать с грузом:
- восстановить груз и перезапустить Торги, если они были запущены;
- выставить груз без Торгов;
- перенести груз в Архив.

С помощью API Средних ставок теперь можно получить цены на грузоперевозки между регионами
Теперь с помощью API Средних ставок можно узнать цены на грузоперевозки между регионами или между регионами и городами. Для этого в полях From или To укажите параметр RegionId и код региона.
Чтобы узнать код региона — воспользуйтесь словарём адресов:
Пример кода:
“From” {
“CityId”: 1
},
“To”: {
“RegionId”: 54
}
В результате вы получите средние ставки на грузоперевозку из Санкт-Петербурга (код города 1) в республику Татарстан (код региона 54).

В API Средних ставок появился кругорейс
Теперь API позволяет получить среднюю ставку на грузоперевозку туда и обратно между городами. Для регионов функция недоступна.
Чтобы узнать цену для кругорейса — используйте параметр RoundTrip. Он может иметь значение true или false.
Пример запроса
{
"From": {
"CityId": 1
},
"To": {
"CityId": 3611
},
"CarType": "open",
"DateFrom": "2022-03-24",
"DateTo": "2022-09-11",
"Frequency": "week",
"WithNds": true,
"RoundTrip": true
}
В результате вы получите средние ставки кругорейса Санкт-Петербург - Москва - Санкт-Петербург

В API Средних ставок появился параметр, показывающий по выбранному направлению количество грузов, которое было на ATI.SU в выбранный период.
В ответе метода average_prices добавился параметр LoadsCount.
Более подробно о количестве грузов можно почитать в FAQ. API Средних ставок

Мы запустили API Индекса ATI.SU по направлениям.
API позволяет получить значение Индекса по 100 самым популярным направлениям в России, которые входят в Общий индекс ATI.SU.
Доступ к API Индекса ATI.SU по направлениям вы получите при покупке лицензии «API Средних ставок».
Подробнее об API Индекса ATI.SU по направлениям

Мы обновили вэбхуки. Добавили больше тем для подписки. Появилась возможность подписаться на события грузов, торгов и персональных предложений.
Посмотреть все доступные темы: https://ati.su/developers/api/webhooks/topics/
А для новых тем, которые требуют фильтрации, также добавили методы получения и редактирования параметров фильтра подписки. С их помощью можно будет получить информацию о параметрах фильтра и отредактировать его: заменить, убрать или добавить площадку.
Поддержали механизм аутентификации запросов. Теперь вы сможете достоверно установить, что автор запроса — именно ATI.SU.
Подробнее про новый механизм: https://ati.su/developers/api/webhooks/authentication/

API Средних ставок теперь передаёт ставки за весь маршрут
В методе average_prices добавился новый параметр PricesInRub. Теперь метод возвращает минимальную, максимальную и среднюю стоимость грузоперевозки по всему маршруту, а не только ставку в руб/км как это было раньше.
Подробнее про API Средних ставок

🛠 Завтра с 14 до 20 часов пройдут технические работы
В это время возможны перебои в работе сайта и мобильных приложений, но надеемся, что обойдётся без них.
Если у вас возникнут сложности с доступом к сервисам после 20:00, напишите нам на почту support@ati.su или позвоните +7 812 602-01-09.

Новые типы кузова в сервисе «Средние ставки»

Теперь Средние ставки возвращают в ответе метода all_directions до 6 типов кузова: закрытый, открытый, тентованный, рефрижератор, контейнер и трал.

Чтобы запросить данные по новым типам кузова, передайте в метод average_prices:
- для контейнера ”CarType”:“docker”;
- для трала ”CarType”:“tral”.

Получайте по API cтавки в похожих грузах на ATI.SU

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

Теперь эту информацию можно получить через API. Передайте параметры груза — и сервис вернёт в ответе цены с НДС, без НДС и при оплате наличными.

Узнать больше об обрабатываемых параметрах груза и попробовать работу метода можно на странице описания API Ставок в похожих грузах.

🛠 В среду и четверг с 10 до 12 часов возможны перебои в работе сервисов
3 и 4 апреля планируем провести технические работы. Могут случиться перебои в работе интеграций с API, сайта и мобильных приложений.
Если возникнут сложности с доступом к сервисам после 12:00 МСК, напишите нам на почту support@ati.su или позвоните +7 812 602-01-09.

Изменили контракт в методах поиска краткой информации о фирмах.
Изменили контракт по методам «Групповое получение краткой информации о фирмаx по email» и «Групповое получение краткой информации о фирмаx по ИНН». Если по заданным критериям поиска ничего не найдётся, будет возвращён код 200 и пустой список. Раньше возвращался код 404.
Посмотреть, как работают методы, можно на странице поиска краткой информации о фирмах.

Добавили новые методы для работы с адресами

Теперь для получения геообъектов мы рекомендуем пользоваться новыми методами. Подробнее о методах и правилах работы с ними — читайте на странице описания API адресов:
👉как находить геообъекты по кодам, координатам или названиям;
👉какие геообъекты помечены устаревшими;
👉что делать, если вы не нашли нужный населённый пункт.

Устаревшие методы будут доступны до 1 сентября 2025 года — после этого они поддерживаться не будут.

В API Средних ставок появился разный тоннаж

В сервисе «Средние ставки» появились ставки для разных машин: 1,5 т, 3 т, 5 т, 10 т и 20 т:

1️⃣Чтобы получить направления для всех тоннажей — используйте новую версию метода /priceline/license/v2/all_directions.

Старая версия будет поддерживаться в течение года: получить по ней можно только ставки для 20 тонн.

2️⃣Чтобы получить информацию о ставках для определенного тоннажа в методе average_price, используйте параметр Tonnage.

Подробнее — на странице API Средних ставок

Добрый день, Коллеги!

С 1 февраля 2025 года, мы отказываемся от двух устаревших методов:

1)метод [GET] loads/fixedrate/{id} меняется на [GET] v1.2/orders/{id}
2)метод [GET] loads/fixedrate?st=... меняется на [POST] /v1.2/orders/
Если вы используете их в интеграции с нами, просьба перейти на новые методы.
Если у вас возникли вопросы, вы можете задать их в чат поддержки.

Документация в API ATI.SU стала удобнее для интеграторов и разработчиков

Представляем обновления, которые упростят взаимодействие с API ATI.SU для пользователей.
✅ Перевели документацию на новый сервис, чтобы ускорить работу, расширить функциональность и развивать его с каждой новой итерацией.
✅ Добавили комментарии: теперь под статьёй можно оставить отзывы, задать вопрос и получить ответ от специалистов ATI.SU.

👍 В следующей итерации обновлений добавим возможность оставлять реакции, чтобы развивать сервис на основе ваших мнений.
Посмотреть документацию и попробовать метод 👉https://ati.su/developers/

Уважаемые партнёры! Обращаем ваше внимание, что в методе /v1.0/loads поле name (название груза) стало обязательным для заполнения.
Пожалуйста, указывайте название груза при добавлении, а так же запланируйте переход на новый метод версии v2.
Благодарим за понимание!

Уважаемые коллеги! Информируем, что указание в вызовах методов API двух и более слешей подряд будет приводить к ответу Moved Permanently (код 301).

Добрый день, коллеги!

Информируем, что 01 июля 2025 года планируется прекращение поддержки метода /v1.0/loads.

Рекомендуем перейти на метод /v2/cargos до 1 июля, иначе вы не сможете публиковать грузы через API.

Если у вас возникли вопросы, вы можете задать их в чат поддержки.