Интеграция с АТИ (ati.su)

Добавьте новые возможности в свой Битрикс24

Оформите подписку Битрикс24.Маркет Плюс и используйте более 1 500 полезных приложений, представленных в каталоге.

Скриншоты
Приложение содержит 2 активити для дизайнера бизнес-процессов Битрикс24 (работает только на лицензиях с дизайнером бизнес-процессов (Команда, Компания, Профессиональный, Коробочные лицензии)

С помощью приложения вы можете:
1. размещать грузы на сайте АвтоТрансИнфо (ati.su) прямо из вашего Битрикс24
2. получать информацию о компаниях участников сервиса по коду АТИ (реквизиты, контакты, связанные компании)

Для работы приложения необходимо получить токен авторизации к API. В настоящий момент доступ к API бесплатный. Инструкция по регистрации по ссылке https://ati.su/developers/auth/


Входные параметры для активити Размещение груза (что передаём на АТИ):
  • access_token API АТИ (строка) - секретный ключ, который вам выдаст сервис ati после запроса
  • Наименование груза (строка) - описание груза
  • Класс опасности ADR (число) - принимает значение от 1 до 9 или не заполняйте
  • Вес, т (число) - вес груза
  • Ремней, шт (число) - количество ремней, при необходимости
  • Объем, м3 (число) - объём груза
  • Габариты Длинна (число) - длинна груза
  • Габариты Ширина (число) - ширина груза
  • Габариты Высота (число) - высота груза
  • Тип упаковки - id типа упаковки справочника АТИ
  • Количество упаковок - число
  • Вариант загрузки (число) 1 - "только отдельной машиной", 2 - "отдельной или догрузом", 3 - "только догрузом"
  • Город загрузки (точно) (строка, множественно) - город/города загрузки
  • Улица/район загрузки (строка, множественно) - улица/район загрузки (для крупных городов)
  • Город разгрузки (строка, множественно) - город/города разгрузки
  • Улица/район разгрузки (строка, множественно) - улица/район разгрузки (для крупных городов)
  • Кругорейс (Y/N) - значение переменной типа "Да/нет"
  • Тип кузова (число) - сумма id кузовов справочника ati
  • Коники (Y/N) - значение переменной типа "Да/нет"
  • Температура от-до (число, множественно) - значения температурного режима, при необходимости, пример: -2, -6
  • Тип загрузки (число) - сумма id типов загрузки справочника ati
  • Тип разгрузки (число) - сумма id типов разгрузки справочника ati
  • Количество машин (число) - количество машин
  • Загрузка с даты (дата) - дата загрузки
  • + дней к дате (число) значение от 0 до 9 при необходимости
  • Круглосуточная загрузка (Y/N) - значение переменной типа "Да/нет"
  • Возможен торг (Y/N) - значение переменной типа "Да/нет"
  • Запрос стоимости (Y/N) - значение переменной типа "Да/нет"
  • Ставка наличными (число) - Ставка наличными
  • Ставка б/нал с НДС (число) - Ставка б/нал с НДС
  • Ставка б/нал без НДС (число) - Ставка б/нал без НДС
  • Предоплата % (число) - процент предоплаты деньгами, при необходимости
  • Предоплата топливом (Y/N) - значение переменной типа "Да/нет"
  • Оплата на выгрузке (Y/N) - значение переменной типа "Да/нет"
  • Приоритетный показ (Y/N) - значение переменной типа "Да/нет". При значении "Да" - груз размещается со следующими параметрами: "Ставка за просмотр = 0,6 ат., Лимит на заявку = 5 ат., Суточный лимит = 5ат. , Только платным "Да"
  • Примечание (текст) - примечание (при необходимости)
  • Контакты (число) -  id пользователя сервиса АТИ

Возвращаемые параметры:
  • Ошибка - ошибка размещения, в случае возникновения
  • Результат размещения - id размещённого груза
  • Таймаут - таймаут операции
Для удобства использования рекомендуем для параметров: Тип кузова, Тип загрузки/Тип разгрузки, Тип упаковки и Контакты создать справочники на инфоблоках (списках/процессах) со значениями и id этих значений на АТИ (см скриншоты). Значения справочников можно получить в документации API АТИ или у нас по запросу.


Входные параметры для активити Получение данных о компании (что передаём на АТИ):

  • access_token API АТИ - секретный ключ, который вам выдаст сервис ati после запроса
  • Код АТИ - код участника сервиса
  • Тип сущности - множественный выбор запрашиваемых данных: Получить данные компании, Получить Контакты компании, Получить реквизиты компании.
Возвращаемые параметры:
  • Форма собственности
  • Полное наименование
  • Профиль деятельности
  • Сайт
  • Город
  • Количество звезд (баллы)
  • Количество упоминаний на форуме НП
  • Количество претензий
  • Количество рекомендаций
  • ИНН
  • ОГРН
  • КПП
  • Дата регистрации
  • Количество машин
  • Реквизиты - массив массивов(!) - активити возвращает все реквизиты, сохраненные в карточке компании на все связанные компании.

    Ключи вложенного массива:
    requisite_type_id, legal_name, inn, ogrn, kpp, bank, rs, ks, bik, okpo, legal_address, post_address, full_name, position, act_upon
  • Контакты - массив массивов(!) - активити возвращает все контакты, сохраненные в карточке компании.

    Ключи вложенного массива:
    contact_id, name, phone, mobile_phone, icq, email
  • Таймаут - таймаут операции
Подробнее структуре данных можно посмотреть в документации API сервиса АТИ по ссылке https://ati.su/developers/api/catalogs/organizations/

Версия 1
Активити для размещения грузов на сервисе грузоперевозок ati.su

По вопросам технической поддержки обращайтесь:
- в чат Битрикс24.Network
- whatsapp
- info@stobitrix.ru
Решение устанавливается автоматически.
После установки активити сразу доступно для использования в дизайнере Бизнес-процессов.