Системная интеграция — удалённая работа в Москве

Автоматизировать бизнес. Сфера деятельности: Экспедиционная компания. Нужно сделать интеграцию между ЦРМ И КОНТУР БУХГАЛТЕРИЕЙ.

Автоматизировать бизнес. Сфера деятельности: Консалтинг. Пожелания и особенности: Необходимо настроить EvaProject. Важно, чтобы вы имели опыт работы с продуктом.

Автоматизировать бизнес. Сфера деятельности: Настроить выгрузку данных.

Автоматизировать бизнес. Сфера деятельности: Такси. Пожелания и особенности: Общие сведения 1.1. Назначение документа Настоящее техническое задание определяет требования к разработке двусторонней интеграции между Яндекс Диспетчерской (fleet.yandex.ru) и Битрикс24 (облачная версия, тариф Профессиональный). Документ предназначен для передачи интеграторам на аутсорсе. 1.2. Описание бизнеса Заказчик — транспортная компания, оказывающая услуги такси и курьерской доставки через платформу Яндекс Go. Масштаб: Более 5 парков (юридических лиц), подключённых к Яндекс Диспетчерской Более 500 активных водителей и курьеров Битрикс24 — чистый портал, тариф Профессиональный Серверные мощности для middleware — готовы арендовать 1.3. Цели интеграции Централизация управления водителями, курьерами, автомобилями и заказами в едином интерфейсе Битрикс24 Двусторонняя синхронизация данных в режиме реального времени Финансовый учёт и аналитика по паркам, водителям, заказам Управление балансами и начислениями из Битрикс24 Связь с 1С, уведомления в Telegram и Битрикс24 2. Технический ландшафт 2.1. Yandex Fleet API Базовый URL: https://fleet-api.taxi.yandex.net Авторизация: заголовки X-Client-ID, X-API-Key, X-Park-ID Формат: REST API, JSON, POST-запросы Доступные группы методов: Группа API Методы Направление ContractorProfiles Список водителей/курьеров, создание, редактирование, привязка авто Чтение + Запись Orders Список заказов, трек по заказу Только чтение Transactions Транзакции по водителю, по заказу, по парку; создание транзакции Чтение + Запись DriverWorkRules Список условий работы Только чтение Важно: для каждого парка требуется отдельный набор ключей (Client ID + API Key + Park ID). Ключи получаются в разделе API диспетчерской или через поддержку [Email скрыт]. Также необходимо предоставить IP-адрес middleware-сервера в белый список. 2.2. Битрикс24 REST API Тип: Облачный, тариф Профессиональный Авторизация: Входящие вебхуки (бессрочный токен) и/или локальное приложение (OAuth 2.0) Ограничения: Leaky Bucket — 2 запроса/сек, порог блокировки 50 запросов Рекомендация: использовать локальное приложение (не вебхук) для поддержки событий и встраивания в интерфейс 2.3. Архитектура решения Требуется middleware-сервер (арендованный VPS/облако), который выполняет роль прокси между Yandex Fleet API и Битрикс24 REST API: Поллинг Yandex Fleet API по расписанию (каждые 1-3 минуты) для обнаружения изменений Обработка исходящих вебхуков Битрикс24 для обратной записи в Fleet Очередь задач (Redis/RabbitMQ) для соблюдения rate-limit Битрикс24 (2 запроса/сек) Логирование всех операций и обработка ошибок Рекомендуемый стек middleware: Node.js / Python (FastAPI), PostgreSQL, Redis, Docker. Рекомендуемый хостинг: Yandex Cloud / Selectel / Timeweb Cloud — VPS от 2 vCPU, 4 GB RAM, SSD 40 GB. 3. Объём работ и функциональные требования 3.1. Настройка Битрикс24 (с нуля) 3.1.1. Смарт-процессы (рекомендуемый подход) Создать следующие смарт-процессы в CRM: СП «Водители / Курьеры» Поле Тип Источник Fleet Примечание Fleet ID String driver_profile.id Уникальный ключ связи Park ID String park.id Принадлежность к парку ФИО String last_name, first_name, middle_name Телефон String phone Тип (такси/курьер) List work_rule Статус (working/fired/…) List work_status Стадия воронки Баланс Number account.balance Автообновление Условия работы List work_rule_id Автомобиль Связь car_id Связь с СП Авто Дата создания DateTime created_date СП «Автомобили» Поле Тип Источник Fleet Примечание Car ID String car.id Уникальный ключ Марка, модель String brand, model Госномер String number Цвет String color Год выпуска Number year VIN String vin СП «Заказы» Поле Тип Источник Fleet Примечание Order ID String order.id Уникальный ключ Водитель/курьер Связь driver_profile.id Связь с СП Статус заказа List status Стадия воронки Адрес подачи String route.point_from Адрес назначения String route.point_to Стоимость Number price Тип оплаты List payment_type нал/безнал/корп Дата/время DateTime booked_at, ended_at Park ID String park.id СП «Транзакции» Поле Тип Источник Fleet Примечание Transaction ID String id Уникальный ключ Водитель Связь driver_profile_id Категория List category_id ride, tip, fine, и т.д. Сумма Number amount Описание String description Дата DateTime event_at Park ID String park.id 3.1.2. Справочник «Парки» Создать справочник с полями: Park ID, Название юрлица, Client ID (не отображать), API Key (не отображать, хранить на middleware), Статус синхронизации. 3.2. Синхронизация Yandex Fleet ? Битрикс24 (чтение) Водители / Курьеры: Поллинг /v1/parks/driver-profiles/list по каждому парку каждые 3 минуты Сопоставление по Fleet ID: если нет — создать; если есть — обновить изменившиеся поля Обновление баланса водителя при каждом поллинге Заказы: Поллинг /v1/parks/orders/list каждые 1-2 минуты (booked_at от последней синхронизации) Создание элемента СП «Заказы» с привязкой к водителю Обновление статуса заказа (стадии воронки): новый ? в пути ? выполнен ? отменён Транзакции: Поллинг /v2/parks/transactions/list каждые 5 минут (event_at от последней синхронизации) Создание элемента СП «Транзакции» с привязкой к водителю и заказу Дедупликация по Transaction ID 3.3. Синхронизация Битрикс24 ? Yandex Fleet (запись) Создание водителя / курьера: При создании элемента СП «Водители» с пустым Fleet ID — вызов POST /v2/parks/contractors/driver-profile Полученный Fleet ID записывается обратно в Б24 Триггер: исходящий вебхук Битрикс24 на событие создания элемента Начисления / списания баланса: Кнопка/робот в карточке водителя ? POST /v2/parks/driver-profiles/transactions Поля: сумма, описание, категория (partner_bonus, partner_ride_fee и др.) Обязательно: X-Idempotency-Token для защиты от дублирования Привязка автомобиля: При изменении поля «Автомобиль» в карточке водителя ? PUT /v1/parks/driver-profiles/car-bindings 3.4. Уведомления В Битрикс24: Ошибки синхронизации — уведомление ответственному в живую ленту/чат Новый водитель зарегистрирован — уведомление менеджеру Баланс водителя ниже порога — уведомление бухгалтеру В Telegram: Критические ошибки синхронизации (middleware down, API недоступен, auth error) Сводка за день: кол-во заказов, выручка, новые водители (ежедневный дайджест в заданное время) Реализация: Telegram Bot API, бот создаётся через@BotFather, токен хранится на middleware 3.5. Аналитика и отчёты В Битрикс24 необходимо настроить следующие отчёты/дашборды: Сводка по паркам: кол-во водителей, заказов, выручка, средний баланс (по каждому парку и суммарно) Топ водителей: по кол-ву заказов, по выручке, по отменам Финансовый отчёт: транзакции по категориям, сальдо, динамика за период Дашборд реального времени: активные водители, заказы в работе, выручка сегодня Реализация: стандартные отчёты CRM Битрикс24 + встроенное приложение (ифрейм) с графиками на базе данных middleware. 3.6. Интеграция с 1С Подготовить REST API эндпоинты на middleware для выгрузки данных в 1С: GET /api/v1/drivers — список водителей с балансами GET /api/v1/transactions?from=&to= — транзакции за период GET /api/v1/orders?from=&to= — заказы за период GET /api/v1/reports/daily — сводный отчёт Авторизация: API-ключ в заголовке. Формат: JSON. На стороне 1С обработка разрабатывается отдельно (не входит в объём, если не оговорено иное). 4. Нефункциональные требования 4.1. Надёжность Очередь повторных попыток (retry queue) при ошибках API с экспоненциальным backoff Идемпотентность всех операций записи (дедупликация по ID и X-Idempotency-Token) Автоматический перезапуск middleware (супервизор / Docker restart policy) 4.2. Производительность Соблюдение rate-limit Битрикс24 (2 запроса/сек, порог 50) Пакетная обработка (batch) для массовых операций (500+ водителей ? 5+ парков) Латентность синхронизации не более 5 минут для заказов 4.3. Безопасность API-ключи Yandex Fleet хранятся только на middleware (не в Битрикс24) HTTPS для всех соединений IP-whitelist на middleware для доступа к Yandex Fleet API Разделение прав в Битрикс24: роли «Админ интеграции», «Менеджер парка», «Бухгалтер» 4.4. Логирование и мониторинг Логи всех API-запросов с временем, статус-кодом, телом ошибки Ротация логов (хранить 30 дней) Health-check эндпоинт на middleware (/health) Алерты в Telegram при даунтайме > 5 минут 5. Состав поставки № Артефакт Формат 1 Middleware-сервис (исходный код + Docker) Git-репозиторий 2 Настроенный портал Битрикс24 (СП, поля, воронки, роли) Настройка на портале 3 Локальное приложение Битрикс24 (дашборд, кнопки управления) JS-приложение 4 Telegram-бот для уведомлений В составе middleware 5 REST API для 1С (эндпоинты выгрузки) В составе middleware 6 Документация для администратора PDF / Wiki 7 Инструкция пользователя PDF / Wiki 8 Скрипт первоначальной миграции данных В составе middleware 6. Этапы и сроки № Этап Срок Результат Критерий приёмки 1 Аналитика и проектирование 1 нед. Схема архит., маппинг полей Согласование заказчиком 2 Настройка Битрикс24 (СП, поля, роли) 1 нед. Готовый портал Все СП и поля созданы 3 Middleware: синхронизация Fleet ? Б24 2 нед. Работающий поллинг Данные в Б24 совпадают с Fleet 4 Middleware: обратная запись Б24 ? Fleet 1.5 нед. Создание/начисления Данные появляются в Fleet 5 Уведомления (Telegram + Б24) 1 нед. Бот + алерты Уведомления приходят 6 Дашборды и отчёты 1.5 нед. Работающие отчёты Данные корректны 7 API для 1С + документация 1 нед. Swagger / доки Эндпоинты отвечают 8 Тестирование, багфикс, сдача 1 нед. Акт приёмки Все сценарии пройдены ИТОГО ~10 нед. 7. Требования к исполнителю Опыт работы с Yandex Fleet API (подтверждённые кейсы) Опыт разработки интеграций для Битрикс24 облачного (REST API, локальные приложения) Опыт развёртывания на VPS / облаке (Docker, CI/CD) Знание особенностей rate-limit Битрикс24 и Yandex Fleet Опыт с Telegram Bot API 8. Обязанности заказчика Предоставить доступ к порталу Битрикс24 (админ) Предоставить API-ключи Yandex Fleet по всем паркам (Client ID, API Key, Park ID) Арендовать VPS/облако и предоставить SSH-доступ исполнителю Создать Telegram-бота и передать токен + chat_id группы Назначить ответственного для приёмки этапов Предоставить список парков с названиями юрлиц 9. Гарантийные обязательства Гарантийный период: [__] месяцев с момента подписания акта приёмки Исправление багов в рамках ТЗ — бесплатно Адаптация под изменения Yandex Fleet API (в пределах гарантии, если не меняется объём ТЗ) Техподдержка после гарантии — по отдельному договору 10. Известные риски и ограничения Риск Влияние Митигация Yandex Fleet API не поддерживает webhook-пуши (только поллинг) Задержка 1-5 мин Оптимизация интервалов Rate-limit Битрикс24 (2 запр/сек) Медленная миграция Очередь + batch Изменение API Yandex без уведомления Поломка синхронизации Мониторинг + алерты Недоступность middleware Простой синхронизации Docker restart + health-check IP не в whitelist Yandex 403 от API Статический IP на VPS.

Автоматизировать бизнес. Сфера деятельности: Маркетинг и много руины.

Сфера деятельности: Обучение в колледже.

Сфера деятельности: Операторская.