Приложение содержит 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
Решение устанавливается автоматически.
После установки активити сразу доступно для использования в дизайнере Бизнес-процессов.