Сводите балансы водителей до того, как уйдёт выплата

Агент обращается к публичному API taxiCRM на поддомене вашего парка и начинает со списка кабинетов — именно к ним привязаны поездки и транзакции. Дальше читаются водители и их балансы, смены, поездки, выплаты и реквизиты, автомобили и договоры аренды, штрафы, чаты с водителями и воронки CRM парка. Из этого складываются утренняя сводка за вчера, картина задолженностей и список тех, кто подходит к выплате.

Баланс водителя — не строчка в карточке, а результат: смены, поездки, удержания, штрафы и переводы ложатся в него транзакциями, и агент пересобирает сумму из них, а не доверяет одному числу. Кабинетов агрегаторов у парка обычно несколько, и один водитель нередко работает сразу через два, так что итог по одному кабинету — часть заработка, а не весь. Поэтому агент всегда называет, по какому кабинету и за какой период посчитано.

На запись агент делает то, что не двигает деньги: регистрирует водителя, заводит сделку в воронке парка или автомобиль, ставит договор аренды на паузу, пишет водителю в чат. Каждое такое действие показывается до отправки — сообщение уходит живому человеку за рулём, а не в отчёт. Денежные методы устроены жёстче: выплата водителю, изменение баланса и снятие блокировки транзакции по спецификации закрыты и отвечают 402, пока их не откроют по запросу в поддержку taxiCRM.

Подключение — поддомен парка и его API-ключ; подпись каждого запроса коннектор считает сам, передавать её вручную не нужно. Ключ парковый, а не пользовательский: отдельной учётной записи за агентом нет, он видит все кабинеты аккаунта, а доступ отзывается сменой ключа. Списки агент читает постранично и всегда с границами периода, поэтому большой парк не превращается в одну тяжёлую выгрузку, а старые смены не тянутся в свежую сводку. Если метод закрыт, смен за период не было или чат пуст, агент скажет это прямо, а не покажет пустую таблицу.