Платформа
taxiCRM
Водители, поездки, смены, выплаты и аренда автомобилей.
taxiCRM
Приложение taxiCRM подключает публичный API парка к Promto. Агент может работать с водителями, поездками, сменами, автомобилями, выплатами, балансом, штрафами, чатами и арендой в пределах подключённых модулей taxiCRM.
Назначение
Подключение помогает собрать оперативную сводку по парку, проверить активных водителей и смены, сверить поездки и подготовить действия, связанные с выплатами или арендой.
Подключение
- Получите API-ключ taxiCRM и убедитесь, что нужные модули API включены в аккаунте.
- В приложении укажите HTTPS-адрес парка в домене
taxicrm.ru. - Вставьте API-ключ и нажмите Проверить и подключить.
У taxiCRM нет универсального безопасного метода проверки ключа. Поэтому при подключении Promto проверяет формат адреса и ключа, а фактические права определяются первым запросом к выбранному методу. Ключ хранится только на сервере.
Интерфейс и данные
На главной есть сценарии Водители и Смены и поездки. В настройках показаны адрес парка, примеры методов, доступ агента, последняя ошибка и отключение.
Приложение не показывает полный диспетчерский интерфейс. Агент получает данные по запросу и возвращает сводку в чат.
Возможности агента
Инструмент — promto_taxicrm. Сначала вызывается capabilities. Для безопасного чтения агент задаёт method=GET, хотя Promto физически отправляет запрос в taxiCRM как подписанный POST JSON.
Примеры путей относительно /api/public/v1:
/user/list— водители;/trip/list— поездки;/shifts/listи/shifts/stat/get— смены;/cars/list— автомобили;/user/balance/get— баланс;/user/payout/list— выплаты;/cars/rents/list— аренда;/chats/listи/chats/messages/list— чаты.
Timestamp и подпись SHA1(json + API key) добавляет сервер Promto. Агент ключа не получает.
Сценарии
Активные водители
Через promto_taxicrm сначала вызови capabilities, затем безопасно прочитай /user/list. Покажи активных водителей и только необходимые рабочие поля. Ничего не меняй.Открытые смены
Через promto_taxicrm прочитай смены и поездки, сопоставь открытые смены с водителями и отдельно покажи аномалии.Ограничения и подтверждения
- Все методы taxiCRM передаются по
POST, поэтому Promto использует точный список известных безопасных путей чтения. - Любой неизвестный путь считается потенциально изменяющим и требует
confirm=true. - Регистрация, сообщения, изменения машин и аренды, выплаты и корректировки баланса выполняются только после явного согласия.
- Денежные методы могут быть недоступны без соответствующего модуля API и возвращать статус 402.
- Адрес должен находиться в домене
taxicrm.ru. - Ответ больше 512 КБ будет усечён.
Если что-то не работает
- Подключение выглядит успешным, а первый запрос отклонён. Это ожидаемая граница проверки: уточните права ключа и подключённые модули taxiCRM.
- 402. Для выбранного денежного действия не подключён модуль API.
- Подтверждение требуется для нового метода чтения. Не обходите защиту: сначала сверьте точный путь со спецификацией и обновите интеграцию.
- Ошибка подписи или времени. Повторите запрос через Promto; timestamp формируется сервером, передавать его вручную не нужно.
- Данные слишком объёмные. Сузьте фильтры и период.