# taxiCRM

Платформа для таксопарков — водители, поездки, выплаты, балансы, смены, чаты, штрафы, авто, аренда, CRM

## Scenarios

### Driver balances before payout
The agent reconciles shifts, trips and transactions and shows which drivers went negative and what balance each one brings into the payout.

### Fines and rental agreements
The agent collects unpaid fines and paused rental agreements and links them to specific cars and drivers in the fleet.

### Morning fleet summary
Every morning the agent sends yesterday totals: trips, shifts and driver transactions broken down by aggregator cabinets.

### Review of driver conversations
The agent goes through fleet chats, collects driver requests left without a reply and shows which questions come up most often.

## How to connect

### Open your fleet cabinet and note the subdomain
The cabinet address looks like https://yourfleet.taxicrm.ru — the part before .taxicrm.ru is the subdomain. The public API lives at the same address; there is no separate API domain.

### Open «Компания» → «Настройки компании» → «API»
In taxiCRM the section «Компания» → «Настройки компании» → «API» (Company → Company settings → API) holds the fleet API key: every request is signed with it — sha1 of body plus key, 40 hex chars in Authorization.

### Copy the fleet API key
One key covers the whole fleet and opens all of its data — drivers, trips, shifts, payouts, penalties, rentals. Treat it as a password: requests signed with it act on the fleet's behalf.

### Ask taxiCRM support to open the payout methods
Per the spec, driver payout, balance change and payout-block change are granted only on request through taxiCRM support. Without it those three methods answer 402; reading data works right away.

## FAQ

### How do I connect taxiCRM?
With the fleet subdomain and API key: the subdomain is the part of your cabinet address before .taxicrm.ru, and the key sits under Company → Company settings → API. The connector signs the request itself, so you do not need to pass a signature.

### What does the agent see in taxiCRM?
Drivers and their balances, trips, shifts, transactions, payouts and payment details, cars and rental agreements, fines, driver chats and the fleet CRM pipelines.

### Does the agent write to taxiCRM?
It can: register drivers, create deals and cars, pause a rental and message a driver in chat. By default it works in read and summary mode.

### Why do some methods answer 402?
Paying out a driver, changing a balance and unblocking a transaction are opened only on request to taxiCRM support, as the spec states. Reading data works right after you connect.

[Open taxiCRM](https://taxicrm.ru)