Категории

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 / Интеграции → Создать токен

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

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

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

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

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

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

Подключение

Base URL: 

<a href="https://api.truestats.ru">https://api.truestats.ru</a>

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

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

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

curl -H "X-Api-Token: <токен>" "<a href="https://api.truestats.ru/">https://api.truestats.ru/</a><endpoint>"</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.

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

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