Как установить и настроить расширение ATI.SU для работы в 1С
API ATI.SU позволяет работать с грузами, Заказами и Площадками ATI.SU из конфигурации «1С:Управление Торговлей». Не нужно переходить на сайт ATI.SU — основная функциональность доступна напрямую из 1С.
Терминология
Груз
Заявка на перевозку груза, размещенная на сайте ATI.SU.
Заказ ATI.SU
Перевозка, которая полностью оформляется через ATI.SU: от размещения груза до окончания перевозки и подписания документов.
Заказ 1C
Внутренний заказ на платформе «1С:Управление торговлей».
Возможности API
С помощью расширения на основе заказа 1С вы можете:
- добавлять грузы, в том числе сборные;
- заполнять данные по созданному грузу и точки маршрута;
- выбирать способ оплаты;
- выбирать Площадки, на которых нужно разместить груз;
- размещать грузы на ATI.SU;
- выбирать, когда опубликовать груз на Площадках: через определённый интервал или в точное время;
- принимать встречные предложения;
- отправлять предложение взять груз перевозчикам;
- оформлять Заказы ATI.SU;
- работать с документами;
- отслеживать статусы перевозки;
- разрешить перевозчикам забронировать груз на Площадках;
- если на одной из Площадок в торгах появилась ставка, не публиковать груз на другой Площадке.
Методы
Методы для работы с грузами и Площадками ATI.SU: https://ati.su/developers/
Как интегрировать API ATI.SU
Интегрировать API с существующими у вас конфигурациями в «1С:Управление Торговлей» можно с помощью расширения ATI.SU. Расширение необходимо установить и настроить.
Как установить и настроить расширение ATI.SU
Скачайте файл расширения.
Подключите расширение через клиент «1С:Предприятие»:
1. В меню в правом верхнем углу выберите пункт «Функции для технического специалиста»;
Перейдите в Функции для технического специалиста
Если у вас нет пункта «Функции для технического специалиста» — в меню перейдите в Настройки и выберите пункт «Параметры».
Перейдите в Параметры, если у вас нет Функции для технического специалиста
В открывшемся окне поставьте галочку в блоке «Режим технического специалиста» и сохраните изменения.
Включите Режим технического специалиста
2. В группе «Стандартные» выберите Управление расширениями конфигурации.
Перейдите в Управление расширениями конфигурации
3. В открывшемся окне нажмите на кнопку «Добавить» и выберите файл с расширением в формате *.cfe.
Добавьте расширение
4. Отключите использование безопасного режима для расширения — снимите галочку в соответствующей колонке.
Отключите использование безопасного режима
5. Перезапустите клиент.
Добавьте токен интегратора для своего пользователя на сайте по инструкции.
Как работать с расширением в 1С
После установки и настройки расширения в 1С появится новый раздел ATI.SU.
Раздел ATI.SU в 1С
Основное рабочее пространство для работы — это АРМ Логиста.
АРМ Логиста
В АРМ Логиста вы можете работать с грузами и Заказами.
В АРМ Логиста можно работать с грузами и Заказами на ATI.SU
Как работать с Площадками ATI.SU в 1С
Чтобы начать работать с Площадками ATI.SU в 1С, перейдите в раздел «ATI.SU».
Перейдите в раздел «ATI.SU»
В блоке «АРМ» перейдите в Настройки.
Перейдите в Настройки
Нажмите на кнопку «Загрузить справочники» — контакты и данные Площадок загрузятся с ATI.SU автоматически.
Загрузите данные Площадок
Также загрузить данные Площадок можно, нажав на количество Площадок. Если у вас ещё не добавлены Площадки — будет отображаться 0.
Загрузите данные Площадок
Вы перейдёте в раздел «Справочники» на вкладку «Площадки». Нажмите на кнопку «Загрузить из ATI.SU» — данные Площадок загрузятся в 1С.
Нажмите на кнопку «Загрузить из ATI.SU»
Также в раздел «Площадки» можно перейти с главной страницы расширения.
Перейдите в раздел «Площадки»
В каждом грузе на вкладке «Площадки» появится возможность выбрать, на какой Площадке нужно разместить груз.
Чтобы выбрать Площадку, необходимо поставить галочку напротив необходимой Площадки и выбрать режим публикации: сейчас, через 15 минут, через час, точное время и т. д.
Если вы выбираете режим «В точное время» — заполните поле «Точное время публикации».
Выберите время публикации груза на Площадке
Также можно настроить дополнительные параметры публикации груза:
- Если вы размещаете груз на нескольких Площадках — можно не публиковать груз с отложенной публикацией на другой Площадке, если появилась ставка в торгах на одной из Площадок.
Например, вы разместили груз с торгами на Площадке 1 и сделали отложенную публикацию этого же груза на Площадке 2. Тогда если на Площадке 1 перевозчик сделал ставку в торгах, то на Площадке 2 груз не опубликуется.
Выберите дополнительную настройку
2. Разрешить перевозчикам забронировать груз и оформить Заказ.
Разрешите перевозчикам бронировать груз
Как обновить расширение
Чтобы обновить Расширение ATI.SU на актуальную версию, воспользуйтесь инструкцией.
Как получить доступ к другим возможностям ATI.SU через 1С
Если функциональности расширения недостаточно — воспользуйтесь API ATI.SU. Доступны API Поиска грузов, Машин и многие другие.
Для вызова любого метода api.ati.su можно воспользоваться следующей процедурой:
Процедура ВыполнитьHTTPЗапросПростой(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса = "", ПутьКФайлу = "") Экспорт
//Получение токена авторизации
ТокенАвторизации = "1234567890abcdef1234567890abcdef";
ЗаголовкиHTTP = Новый Соответствие();
ЗаголовкиHTTP.Вставить("Accept", "application/json");
ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
ЗаголовкиHTTP.Вставить("Authorization", "Bearer " + ТокенАвторизации);
HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
Если Не ПустаяСтрока(ТекстЗапроса) Тогда
HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
ИначеЕсли Не ПустаяСтрока(ПутьКФайлу) Тогда
HTTPЗапрос.УстановитьИмяФайлаТела(ПутьКФайлу);
КонецЕсли;
ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка
Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
Сообщить("Код ответа: " + Ответ.КодСостояния);
Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
Исключение
Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
КонецПопытки;
КонецПроцедуры
//Получение токена авторизации
ТокенАвторизации = "1234567890abcdef1234567890abcdef";
ЗаголовкиHTTP = Новый Соответствие();
ЗаголовкиHTTP.Вставить("Accept", "application/json");
ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
ЗаголовкиHTTP.Вставить("Authorization", "Bearer " + ТокенАвторизации);
HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
Если Не ПустаяСтрока(ТекстЗапроса) Тогда
HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
ИначеЕсли Не ПустаяСтрока(ПутьКФайлу) Тогда
HTTPЗапрос.УстановитьИмяФайлаТела(ПутьКФайлу);
КонецЕсли;
ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка
Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
Сообщить("Код ответа: " + Ответ.КодСостояния);
Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
Исключение
Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
КонецПопытки;
КонецПроцедуры
Пример вызова процедуры для метода «Групповое получение краткой информации о фирмаx по ИНН [1.2]»:
ВыполнитьHTTPЗапрос("POST", "api.ati.su", "v1.2/firms/search/summaries", "[""1234567890"", ""0987654321""]");
Если вы не нашли ответа на свой вопрос — свяжитесь с нами
Консультанты ATI.SU ответят на ваши вопросы по будням с 9:00 до 18:00 МСК.
Вам помогла эта статья?