Формируйте и публикуйте заявки на перевозку в ATI.SU непосредственно из карточки сделки. Маршрут, параметры грузов, требования к транспорту и условия оплаты — в отдельной вкладке вашего Битрикс24.
Приложение связывает подготовку перевозки в CRM с публикацией на площадке ATI.SU.
Приложение помогает логистам подготовить заявку, сохранить данные перевозки в Битрикс24 и передать их в ATI.SU. Каждая заявка формируется в контексте конкретной сделки.
Подготовьте маршрут перевозки во вкладке ATI.SU, связанной с конкретной сделкой.
Соберите грузовые позиции для одного маршрута, сохранив сведения о каждой из них.
Передайте условия, которые нужны для перевозки ваших грузов.
Заполните финансовые условия до передачи заявки на площадку.
Используйте единые настройки ATI.SU для сотрудников портала.
Получайте понятный результат публикации и проверяйте историю обращений к ATI.SU.
Первоначальную настройку выполняет администратор портала. Подготовьте аккаунт ATI.SU и API-токен, затем настройте доступ и общие параметры публикации.
Администратор портала Битрикс24 устанавливает приложение и подтверждает запрашиваемые права. При установке создаются пользовательские поля сделок, хранилища данных и вкладка ATI.SU в карточке сделки.
После установки откройте приложение через левое меню Битрикс24. Подключение к ATI.SU и общие настройки выполняет администратор портала.
Получите токен для аккаунта ATI.SU, от имени которого будете публиковать грузы. Убедитесь, что у него есть права на получение справочников и публикацию грузов. Введите токен в поле API-ключа и нажмите «Сохранить настройки».
После сохранения нового токена приложение запускает загрузку словарей. При необходимости нажмите «Обновить словари ATI.su». Будут загружены типы кузовов, способы загрузки и выгрузки, контакты, площадки и валюты. Дождитесь завершения; если списки ещё не появились, обновите страницу.
Выберите сотрудников, которым разрешена работа с приложением. Администратор имеет доступ к приложению; остальным пользователям он предоставляется через этот список. Сотрудникам также нужны права Битрикс24 на чтение и изменение соответствующих сделок.
Выберите контакт ATI.SU, площадку публикации, валюту и режим: сразу, через 15 или через 30 минут. Эти настройки используются при отправке заявок из сделок.
Нажмите «Сохранить настройки». Убедитесь, что выбранные сотрудники, контакт, площадка, валюта и режим публикации сохранены. После этого можно переходить к подготовке первой заявки.
После настройки сотрудники с доступом могут готовить заявки прямо в CRM. Сначала сохраните сведения о перевозке, затем отправляйте их на площадку.
Перейдите на вкладку ATI.SU в нужной карточке сделки. При повторном открытии приложение загрузит ранее сохранённые данные перевозки.
Выберите города из подсказок ATI.SU, укажите адреса и расписание. Добавьте грузовые позиции: наименование, вес с единицей измерения и объём.
Выберите тип перевозки и кузова, заполните ставку, тип оплаты и вариант НДС. При необходимости укажите способы загрузки и выгрузки, количество машин, температуру и примечание.
Нажмите «Сохранить» и дождитесь подтверждения. Параметры перевозки записываются в пользовательские поля сделки, а список грузов и выбранные города — в хранилище портала.
Нажмите «Опубликовать груз в ATI.su». Если обязательные данные не заполнены или некорректны, приложение подскажет, что нужно исправить. Результат обращения к ATI.SU отобразится пользователю и будет записан в журнал.
После публикации откройте заявку в интерфейсе ATI.SU. Дальнейшее взаимодействие с перевозчиками и работа с опубликованной заявкой выполняются на стороне площадки.
Работа в BitrixMobile не поддерживается. Используйте приложение в веб-интерфейсе Битрикс24.
Доступ к API, лицензии, тарифы и другие услуги ATI.SU приобретаются пользователем непосредственно у ATI.SU и не входят в стоимость приложения. Возможность публикации зависит от прав API-токена и условий вашего аккаунта ATI.SU.
API-токен ATI.SU и служебные данные подключения хранятся на сервере приложения в зашифрованном виде. Параметры перевозки сохраняются в полях сделки и хранилище вашего портала.
Соединение с сервером приложения защищено стандартным публичным HTTPS-сертификатом. Сертификаты Минцифры не используются; дополнительная установка сертификатов не требуется.
Проверьте поля со звёздочкой, выбор городов из подсказок, наличие хотя бы одного груза с наименованием, весом и объёмом, а также ставку и оплату. В настройках приложения должны быть выбраны контакт ATI.SU, площадка и валюта. Подсказка у кнопки сообщает, какие данные нужно заполнить. Во время сохранения или отправки нужно дождаться завершения текущей операции.
Начните вводить название города и выберите подходящий вариант из подсказок ATI.SU. Одного текстового названия недостаточно: для публикации нужен идентификатор города из справочника. Точный адрес загрузки или выгрузки заполняется в отдельном поле.
У каждой позиции должны быть наименование, вес и положительный объём. Допустимый вес одной позиции — от 10 кг до 9999 т. Наименование может содержать до 200 символов, адрес — до 100, примечание — до 1000. Emoji в этих текстовых полях не поддерживаются. Если указываете время, заполните обе границы интервала и часовой пояс; для температуры задайте целые значения «от» и «до» в диапазоне от −100 до +100 °C.
Убедитесь, что API-токен сохранён и имеет необходимые права ATI.SU. Дождитесь окончания загрузки, повторите обновление словарей и при необходимости обновите страницу приложения. Если ошибка сохраняется, запишите её текст и время возникновения и обратитесь в поддержку.
Если для сделки уже записана успешная публикация, приложение блокирует повторную отправку. Проверьте запись в журнале событий и результат в ATI.SU. Перед повторной попыткой после ошибки также проверьте журнал и площадку, чтобы понимать, был ли принят предыдущий запрос.
Результат отображается после отправки заявки. Журнал событий открывается из основного окна приложения: в нём можно обновить список, найти сделку и посмотреть статус обращения, идентификатор заявки ATI.SU или текст ошибки. В разделе «Запрос и ответ» доступны подробности для диагностики.
Если возникла проблема, свяжитесь с нами — поможем разобраться в её причине. Подробное описание позволит быстрее проверить ситуацию и предложить решение.
В форме ниже заполните имя и контакт для ответа. В поле «Задача» укажите, что обращаетесь по приложению «Публикация грузов (интеграция с ATI.SU)», и добавьте:
Снимки экрана при наличии и длинные журналы отправляйте по электронной почте myscaleup@mail.ru. Перед отправкой скройте секретные данные.
Не отправляйте API-токен ATI.SU, пароль от портала или другие секретные данные — ни в форме, ни в письме, ни на снимках экрана.
Свяжитесь с нами любым удобным способом. Мы проведем бесплатный аудит и предложим решение.
