# API / Интеграции
Ссылка на все возможности API и доступные методы ниже:

```
https://api.truestats.ru/api/public/doc
```

Открытый API позволяет автоматически получать данные из TrueStats и использовать их во внешних системах без ручной выгрузки отчетов.

С помощью API можно:

- выгружать данные по продажам, прибыли, товарам и другим показателям;
- строить собственные отчеты и дашборды;
- интегрировать данные TrueStats с CRM, ERP, BI-системами и внутренними сервисами компании;
- загружать себестоимость;
- автоматизировать регулярный обмен данными между системами.

API предназначен для разработчиков и компаний, которым требуется программный доступ к данным TrueStats для создания собственных интеграций и автоматизации бизнес-процессов.

### Возможности публичного API TrueStats

С помощью публичного API можно как получать данные из TrueStats, так и загружать данные обратно в систему для автоматизации процессов и интеграций.

#### Получение данных

Через API можно получать:

#### Магазины

- Получать список подключенных магазинов.
- Определять маркетплейс магазина (WB, Ozon, ЯМ).

#### Оцифровка

- формирование отчетов;
- получение статуса формирования;
- скачивание готового файла.

#### Товары

- Получать список артикулов.
- Получать список баркодов.

#### Себестоимость

- Выгружать себестоимость товаров.
- Массово обновлять (загружать) себестоимость.

#### РНП

- Получать и обновлять список метрик из раздела РНП.

#### Склады

- Получать, создавать, изменять и удалять собственные склады.
- Импортировать позиции и соответствие артикулов, менять настройки остатков.
- Получать, создавать, изменять и удалять складские операции, в том числе массово.
- Получать историю остатков по конкретному товару.

#### План-факт

- Получать, создавать, изменять и удалять планы.
- Менять состав товаров и цели плана.
- Выгружать и загружать план файлом.

#### Финансы

- Получать отчёт ДДС и платёжный календарь.
- Создавать, изменять и удалять операции, в том числе массово; импортировать и экспортировать операции.
- Работать со счетами, контрагентами, статьями, группами статей и обязательствами.

#### Комментарии

- Получать, создавать, изменять и удалять комментарии к артикулам, отмечать избранные.

#### Реклама

- Получать список и сводку рекламных кампаний Wildberries, Ozon и Яндекс.Маркета, отчёты, графики, ключевые слова и кластеры. Только чтение.

#### Создание токена

Токен создаётся в кабинете TrueStats: Настройки → API / Интеграции → Создать токен

![](/attachments/L/P/LPhqCBcYDa_AFREH_a/84276_1.png)

> ⚠️ Важно: токен показывается один раз при создании. Повторно просмотреть / восстановить нельзя — только создать новый.

Токен работает в том кабинете, в котором его выпустили, даже если вы переключитесь в личном кабинете на другой. На вкладке «API / Интеграции» видны токены только текущего кабинета. В одном кабинете можно выпустить до 10 токенов.

Токен получает те же магазины, разделы и режимы доступа, что и пользователь, который его выпустил.

При создании токена выберите права:

- «Только чтение» — токен получает данные, но не может их менять;
- «Чтение и запись» — токен может получать и изменять данные.

Права видны в списке токенов. Токены, созданные раньше, сохраняют прежние права.

![](/attachments/o/O/oOdvZeE5LYZXu5rY_a/84276_2.png)

## Подключение

Base URL:

```
https://api.truestats.ru
```

Заголовок авторизации:

```
X-Api-Token: <токен>
```

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

```
curl -H "X-Api-Token: <токен>" "https://api.truestats.ru/<endpoint>"
```

**Подключение AI-ассистентов через MCP**

TrueStats поддерживает MCP — протокол, который позволяет AI-ассистентам работать с данными вашего кабинета. Вы можете задавать вопросы обычным языком: ассистент получит необходимые данные и поможет их проанализировать.

Например:

- «Какие товары принесли больше всего прибыли за последние 30 дней?»
- «Собери отчёт о прибылях и убытках за второй квартал».
- «Проверь, загружены ли данные по моим магазинам».

**Какие данные можно подключить**

Доступны отчёты и прибыль, склады и остатки, складские операции, РНП, себестоимость, планы, финансовые операции и ДДС, финансовые справочники и обязательства. Можно выбрать отдельный набор данных или подключить всё сразу.

Помимо получения данных, ассистент может выполнять изменения в рамках доступных инструментов. Перед изменением данных он должен запросить ваше подтверждение.

**Как подключить**

1. Создайте токен: «Настройки → API / Интеграции → Создать токен». Токен может выпустить владелец кабинета или приглашённый пользователь с доступом к разделу «API / Интеграции». Чтобы ассистент мог менять данные, выберите права «Чтение и запись».
2. Откройте вкладку «MCP / Интеграция с ИИ» в разделе «Настройки → API / Интеграции» — там пошаговая инструкция. Её можно открыть и в новой вкладке.
3. Выберите набор данных. Для начала рекомендуем «Отчёты и прибыль».
4. Выберите программу и следуйте инструкции на странице: появится кнопка установки, адрес подключения или готовая конфигурация.
5. В новом чате спросите: «Проверь подключение к TrueStats: загружены ли данные по моим магазинам?»

На странице доступны инструкции для Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex CLI и DeepSeek.

Для DeepSeek есть 2 варианта:

- «DeepSeek (сайт)» — работа на chat.deepseek.com через стороннее расширение DeepSeek++ для браузера. API-ключ DeepSeek не нужен;
- «DeepSeek Harness (API)» — официальный клиент DeepSeek. Нужен отдельный API-ключ DeepSeek, запросы оплачиваются с баланса DeepSeek.

Для первой проверки используйте токен TrueStats с правами «Только чтение». Если подключение не работает, откройте блок «Если не работает» на странице инструкции.

**Важно:** для Claude, ChatGPT, Cursor и VS Code токен вводится на странице входа TrueStats. Для Claude Code и Codex CLI — используется при формировании конфигурации. Не отправляйте токен в чат с ассистентом.

Чтобы отключить доступ, удалите использованный токен в разделе **Настройки → API / Интеграции**.