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

Приложение содержит 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/