# Рекомендуемая цена для перевозки — платные сервисы API ATI.SU | Технологии ATI.SU для разработчиков

# Рекомендуемая цена для перевозки

API для получения рекомендуемой цены на текущий день на основании ваших данных и данных ATI.SU.

## Доступ к API

Доступ предоставляется по запросу.

## Методы

### Список доступных направлений
<a id="get-v2-all_directions"></a>

**Версия: 2.0**

Возвращает список доступных направлений - для интеграторов

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/norn/v2/all_directions' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/hidden/recommended_price.openapi.json)

**Пример ответа (200)**

```json
{
  "all_directions": [
    {
      "from_city_id": 0,
      "from_city": "string",
      "to_city_id": 0,
      "to_city": "string",
      "car_types": [
        "close"
      ]
    }
  ]
}
```

**Описание полей ответа**
- `all_directions` — Все направления для перевозчика.
- `all_directions[].from_city_id` — ID пункта загрузки
- `all_directions[].from_city` — Название пункта загрузки
- `all_directions[].to_city_id` — ID пункта разгрузки
- `all_directions[].to_city` — Название пункта разгрузки
- `all_directions[].car_types` — Доступные типы кузовов для направления

**Пример ответа (404)**

```json
{
  "error": "string",
  "reason": "string",
  "details": {
    "any-key": null
  }
}
```

**Описание полей ответа**
- `error` — Основное тело ошибки с описанием
- `reason` — Тип ошибки если имеется
- `details` — Какие-либо дополнительные детали ошибки


### Рекомендуемые цены для перевозки с учетом вашей маржи

<a id="post-v2-chart"></a>

**Версия: 2.0**

Возвращает рекомендованные цены, СС и сделки по заданным параметрам

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/norn/v2/chart' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "car_type": "close",
  "from_city": 1,
  "nds": false,
  "priority": "mixed",
  "rate_per_km": true,
  "time_interval": "3m",
  "to_city": 3611,
  "users_margin": 0
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/hidden/recommended_price.openapi.json)

**Описание полей запроса**
- `car_type` — Тип кузова * `ref` - рефрижераторы * `close` - закрытые. Значение по умолчанию * `open` - открытые * `tent` - тентованный
- `from_city` — ID пункта загрузки. Значение поля `id` в структуре `city` из [словаря ATI.SU](https://ati.su/developers/api/dictionaries/geo/#post-v1-autocomplete-suggestions)
- `nds` — Учитывать ли НДС в цене
- `priority` — Приоритет данных при рассчетах. * `mixed` - баланс; * `partner` - ваши данные; * `ati` - данные ATI.SU.
- `rate_per_km` — Размерность ставки. * `true` - в руб/км. * `false` - в руб.
- `time_interval` — Временной интервал. Один из ['`DisplayedPeriod.three_months`', '`DisplayedPeriod.six_months`', '`DisplayedPeriod.ytd`', '`DisplayedPeriod.year`', '`DisplayedPeriod.three_years`', '`DisplayedPeriod.alltime`']
- `to_city` — ID пункта разгрузки. Значение поля `id` в структуре `city` из [словаря ATI.SU](https://ati.su/developers/api/dictionaries/geo/#post-v1-autocomplete-suggestions)
- `users_margin` — Маржа.

**Пример ответа (200)**

```json
{
  "average_line": [
    {
      "x": "string",
      "y": 0.5
    }
  ],
  "recomended_line": [
    {
      "x": "string",
      "y": 0.5,
      "h": 0
    }
  ],
  "your_executor_deals": [
    {
      "x": "string",
      "y": [
        0.5
      ]
    }
  ],
  "your_customer_deals": [
    {
      "x": "string",
      "y": [
        0.5
      ]
    }
  ],
  "other_executor_deals": [
    {
      "x": "string",
      "y": [
        0.5
      ]
    }
  ],
  "current_price": 0.5,
  "current_cost": 0.5,
  "current_date": "string",
  "confidence_level": 0,
  "mean_margin": 0.5,
  "max_margin": 0.5,
  "min_margin": 0.5,
  "distance": 0
}
```

**Пример ответа (400)**

```json
{
  "error": "string",
  "reason": "string",
  "details": {
    "any-key": null
  }
}
```

**Описание полей ответа**
- `error` — Основное тело ошибки с описанием
- `reason` — Тип ошибки если имеется
- `details` — Какие-либо дополнительные детали ошибки
---

## llms.txt

Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).